{"id":21477660,"url":"https://github.com/wafflecomposite/15.ai-python-api","last_synced_at":"2026-03-27T02:25:46.436Z","repository":{"id":40666144,"uuid":"247771353","full_name":"wafflecomposite/15.ai-Python-API","owner":"wafflecomposite","description":"Python3 script for interaction with https://fifteen.ai/","archived":false,"fork":false,"pushed_at":"2021-10-22T11:51:49.000Z","size":23,"stargazers_count":41,"open_issues_count":0,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-07-15T19:36:22.365Z","etag":null,"topics":["15-ai","api","fifteen","neural-networks","python","python3","voice-synthesis"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wafflecomposite.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-16T17:00:14.000Z","updated_at":"2025-04-29T09:23:32.000Z","dependencies_parsed_at":"2022-08-27T01:01:39.317Z","dependency_job_id":null,"html_url":"https://github.com/wafflecomposite/15.ai-Python-API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/wafflecomposite/15.ai-Python-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wafflecomposite%2F15.ai-Python-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wafflecomposite%2F15.ai-Python-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wafflecomposite%2F15.ai-Python-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wafflecomposite%2F15.ai-Python-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wafflecomposite","download_url":"https://codeload.github.com/wafflecomposite/15.ai-Python-API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wafflecomposite%2F15.ai-Python-API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284902642,"owners_count":27081919,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-17T02:00:06.431Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["15-ai","api","fifteen","neural-networks","python","python3","voice-synthesis"],"created_at":"2024-11-23T11:14:41.421Z","updated_at":"2025-11-17T15:06:01.529Z","avatar_url":"https://github.com/wafflecomposite.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 15API - 15.ai Python API\n\nUnofficial Python3 API for https://fifteen.ai/\n\n## Attention!\n15.ai TOS explicitly states that:\n- Website (and the content generated with it) is intended for strictly non-commercial use.\n- If you want to publish the generated content online, you should include a citation (simply including 15.ai is sufficient).\n  \nThese are simple rules, please follow them. Don't be that guy.\n\n\nRefer to [About](https://fifteen.ai/about) and [FAQ](https://fifteen.ai/faq) for more info.\n\n\nKeep 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.\n\n  \n## Installation\nRequires `python \u003e= 3.6`\n\n\nNote: on Windows, in this and the following commands instead of `python3`, you may want to use `python`\n\nInstall dependencies\n\n    python3 -m pip install requests\nGrab the `fifteen_api.py` and throw it where you want to use it.\n\n## Usage\n### As command line tool:\nYou can use `fifteen_api.py` as executable in terminal. Launch it with\n\n    python3 fifteen_api.py\n ~~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.)\n### As imported module in python code:\nSuppose you put `fifteen_api.py` next to the file in which you want to use it:\n#### Import class:\n\n    from fifteen_api import FifteenAPI\n\n#### Initialize API:\n\n    tts_api = FifteenAPI()\nAlternatively, to get verbose output:\n\n    tts_api = FifteenAPI(show_debug=True)\n\n#### Save TTS to file:\n\n    tts_api.save_to_file(\"Fluttershy\", \"This is a test text\", \"my_tts_file.wav\")\nAlternatively, to automatically generate a unique file name\n\n    tts_api.save_to_file(\"Fluttershy\", \"This is a test text\")\nExample output on successful request: \n\n\n    {'status': 'OK', 'filename': '15ai-Fluttershy-Thisisatestte-1588057995.wav'}\nExample output on failed request: \n\n    {'status': 'Reason_why_it_failed', 'filename': None}\n#### Get TTS as bytes:\n\n    response = tts_api.get_tts_raw(\"Fluttershy\", \"This is a test text\")\nExample output on successful request: \n\n\n    {'status': 'OK', 'data': b'th3r3g03sy0urbyt3s'}\nExample output on failed request: \n\n    {'status': 'Reason_why_it_failed', 'data': None}","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwafflecomposite%2F15.ai-python-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwafflecomposite%2F15.ai-python-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwafflecomposite%2F15.ai-python-api/lists"}