Весело
Весело

Голоса для озвучки по 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
}

Параметры

ПараметрЧто передать
modelid модели озвучки; без него — голоса всех моделей по порядку GET /v1/models
languageязык голоса, ISO 639-1: ru, en, de… (ru-RU — то же, что ru). Голоса без указанного языка, многоязычные, с этим фильтром не показываются
genderfemale, male или neutral
qпоиск по id, имени, характеру и описанию — до 100 знаков
limitсколько голосов на странице: от 1 до 200, по умолчанию 100
cursorследующая страница — значение next_cursor прошлого ответа

Голос в ответе

ПолеЧто это
modelмодель, которой голос говорит
idчто писать в voice
nameимя голоса
noteхарактер словами: «спокойный», «бодрый»; может быть пустым
genderfemale, male или neutral — если он известен
languagesязыки голоса — если они известны
descriptionкоротко своими словами: пол, возраст, акцент, язык, характер — что известно; может не быть
preview_urlпример звучания — ссылка создателя модели или наша; может не быть

Порядок внутри модели: сначала голос по умолчанию, потом русские, потом остальные. Голоса — только самих создателей моделей: их готовые голоса, без голосов из общих библиотек и без клонов.

Ошибки: модели нет или она не для озвучки — 404 model_not_found со списком моделей озвучки; модель не продаётся — 403; на паузе или временно недоступна — 503. Неверное значение параметра — 400 с его именем в param.

← Озвучка · Музыка →

Вся документация одним текстом · Все модели и цены