Enhanced FAKEYOU.COM API lib
Project description
FakeYou.py
Author contact(disocrd) : thedemonicat#9335
FakeYou.py is the offical Python library that helps you to use FakeYou API with simple functions and some featuers.
Documentation!
i'll explian every function and Error handling thing you need so you have as smooth as possible programs with it!
Let's Start!
Calling the main class:
The main class have 1 arguments
-
verbose : type = bool, set it True to make the program more talktiv, default is False
-
Proxy is no longer supported
import fakeyou
fy=fakeyou.FakeYou(verbose=False)
for asynchronous call fakeyou.AsyncFakeYou instead, take a look on examples folder
login
You don't have to request anonymously anymore
import fakeyou
fy=fakeyou.FakeYou()
fy.login(user,password)
if successfuly loged in, it will return session data, otherwise it will raise InvalidCredentials
Error
example script:
import fakeyou
fy=fakeyou.FakeYou()
user=input("Username : ")
password=input("Password : ")
try:
fy.login(user,password)
except fakeyou.exception.InvalidCredentials:
print("Check your username or password.")
get all the categories/voices:
it have one argument and that is size, it decides how much it should return, when its setted to 0, it will return everything, default= 25
import fakeyou
fy=fakeyou.FakeYou()
voices=fy.list_voices(size=100)
FakeYou().list_voices()
returns 13 diffrent list, you can handle it with zip, example:
import fakeyou
fy=fakeyou.FakeYou()
voices=fy.list_voices()
for title,creator in zip(voices.title,voices.creatorUsername):
print(title,creator)
and here's the lists:
- modelTokens
- ttsModelType
- creatorToken
- creatorUsername
- creatorDisplayName
- creatorGavatarHash
- title
- langTag
- isFrontPageFeatured
- isTwitchFeatured
- categoryTokens
- created
- lastUpdate
- json
and goes the same for categories:
import fakeyou
fy=fakeyou.FakeYou()
categories=fy.list_voice_categories()
for name,token in zip(categories.name,categories.categoryToken):
print(name,token)
and here's categories lists:
- categoryToken
- modelType
- maybeSuperCategoryToken
- canDirectlyHaveModels
- canHaveSubCategories
- onlyModsApply
- name
- dropDownName
- isModApproved
- created
- lastUpdate
- deleted
- json
search function
it have one argument, and its query, you just put what you want to search
import fakeyou
fy=fakeyou.FakeYou()
result=fy.search("mario")
for title in result.voices.title:
print(title)
for name in result.categories.name:
print(name)
function search returns 2 objects, voices and categories
say function
this is a function that generates TTS in a specfic voice model it have 3 args, ttsModelToken, text, and filename
- text : is the text to convert to speech
- ttsModelToken : voice model token
- filename : the filename that stores the sound, by default its "fakeyou.wav"
- cooldown : how much it sleeps when get "pending" status, default is 3 (to avoid spamming)
import fakeyou
fy=fakeyou.FakeYou()
fy.say(text="Hello im mario",ttsModelToken="TM:7wbtjphx8h8v")
Error handling
there's only 4 errors
- TooManyRequests
- RequestError
- TtsAttemptFailed
- InvalidCredentials
import fakeyou
fy=fakeyou.FakeYou()
try:
fy.say(text="Hello im mario",ttsModelToken="TM:7wbtjphx8h8v")
except fakeyou.exception.TooManyRequests:
print("Cool down")
Error handling example ^
how to deal with them?
-
well TooManyRequests error because your ip has been banned for a couple of minutes because you were spamming requests, you can use proxy or just wait
-
and RequestError better contact me
-
TtsAttemptFailed is because you maybe used an unsupported language or a wrong token, just check what you have used.
-
InvalidCredentials check username/email and password.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.