15.ai-Python-API

KO | EN

gitlite — search

#python #android #nodejs #php #mongodb #docker #hacktoberfest #ruby #rust #kotlin #buildkite #example

15.ai-Python-API

★ 41 Open GitHub ↗

Python3 script for interaction with https://fifteen.ai/

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 15API - 15.ai Python API

Unofficial Python3 API for https://fifteen.ai/

## Attention!
15.ai TOS explicitly states that:
- Website (and the content generated with it) is intended for strictly non-commercial use.
- If you want to publish the generated content online, you should include a citation (simply including 15.ai is sufficient).
  
These are simple rules, please follow them. Don't be that guy.

Refer to [About](https://fifteen.ai/about) and [FAQ](https://fifteen.ai/faq) for more info.

Keep in mind that the 15.ai is constantly changing and improving, and this script may and eventually will break and will require updating. If it does not work, create issue, or, even better, pull request to fix that.

## Installation
Requires `python >= 3.6`

Note: on Windows, in this and the following commands instead of `python3`, you may want to use `python`

Install dependencies

python3 -m pip install requests
Grab the `fifteen_api.py` and throw it where you want to use it.

## Usage
### As command line tool:
You can use `fifteen_api.py` as executable in terminal. Launch it with

python3 fifteen_api.py
 ~~You will get a list of characters and their available emotions, and you can~~ Visit https://fifteen.ai/app, find the character's name, and use them right there to get your text-to-speech dreams come true as .wav files. (**WARNING**: Character's name is case sensitive! You'll get a server error if you type them in incorrectly.)
### As imported module in python code:
Suppose you put `fifteen_api.py` next to the file in which you want to use it:
#### Import class:

from fifteen_api import FifteenAPI

#### Initialize API:

tts_api = FifteenAPI()
Alternatively, to get verbose output:

tts_api = FifteenAPI(show_debug=True)

#### Save TTS to file:

tts_api.save_to_file("Fluttershy", "This is a test text", "my_tts_file.wav")
Alternatively, to automatically generate a unique file name

tts_api.save_to_file("Fluttershy", "This is a test text")
Example output on successful request:

{'status': 'OK', 'filename': '15ai-Fluttershy-Thisisatestte-1588057995.wav'}
Example output on failed request:

{'status': 'Reason_why_it_failed', 'filename': None}
#### Get TTS as bytes:

response = tts_api.get_tts_raw("Fluttershy", "This is a test text")
Example output on successful request:

{'status': 'OK', 'data': b'th3r3g03sy0urbyt3s'}
Example output on failed request:

{'status': 'Reason_why_it_failed', 'data': None}

15.ai-Python-API

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README