Голоса для озвучки по API
Голоса моделей озвучки: список без ключа, поиск по языку, полу и имени, id для поля voice. Русские голоса — первыми.
Обновлено:
Голос задаётся полем voice в озвучке. До 12 голосов модели — прямо в её карточке (audio.voices), все — в GET https://veselo.ai/v1/audio/voices. Ключ не нужен. Русские голоса — ?language=ru: у многоязычных голосов, например у нейросетей Студии, язык не указан, и этот фильтр их не показывает.
curl
curl -s "https://veselo.ai/v1/audio/voices?model=google/gemini-3.8-flash-tts"Python
import requests # pip install requests
r = requests.get("https://veselo.ai/v1/audio/voices", params={"model": "google/gemini-3.8-flash-tts"}, timeout=30)
for v in r.json()["data"]:
print(v["id"], v["name"], v.get("gender"), v.get("languages"))Ответ
{
"object": "list",
"data": [
{ "model": "google/gemini-3.8-flash-tts", "id": "Kore", "name": "…", "note": "…" }
],
"next_cursor": null
}Параметры
| Параметр | Что передать |
|---|---|
model | id модели озвучки; без него — голоса всех моделей по порядку GET /v1/models |
language | язык голоса, ISO 639-1: ru, en, de… (ru-RU — то же, что ru). Голоса без указанного языка, многоязычные, с этим фильтром не показываются |
gender | female, male или neutral |
q | поиск по id, имени, характеру и описанию — до 100 знаков |
limit | сколько голосов на странице: от 1 до 200, по умолчанию 100 |
cursor | следующая страница — значение next_cursor прошлого ответа |
Голос в ответе
| Поле | Что это |
|---|---|
model | модель, которой голос говорит |
id | что писать в voice |
name | имя голоса |
note | характер словами: «спокойный», «бодрый»; может быть пустым |
gender | female, male или neutral — если он известен |
languages | языки голоса — если они известны |
description | коротко своими словами: пол, возраст, акцент, язык, характер — что известно; может не быть |
preview_url | пример звучания — ссылка создателя модели или наша; может не быть |
Порядок внутри модели: сначала голос по умолчанию, потом русские, потом остальные. Голоса — только самих создателей моделей: их готовые голоса, без голосов из общих библиотек и без клонов.
Ошибки: модели нет или она не для озвучки — 404 model_not_found со списком моделей озвучки; модель не продаётся — 403; на паузе или временно недоступна — 503. Неверное значение параметра — 400 с его именем в param.