---
title: "Голоса для озвучки по API"
description: "Голоса моделей озвучки: список без ключа, поиск по языку, полу и имени, id для поля voice. Русские голоса — первыми."
url: https://veselo.ai/docs/voices
updated: 2026-11-17T01:27:17.429Z
---

# Голоса для озвучки по API

Голоса моделей озвучки: список без ключа, поиск по языку, полу и имени, id для поля voice. Русские голоса — первыми.

Обновлено: 17 ноября 2026 г.

Голос задаётся полем `voice` в [озвучке](https://veselo.ai/docs/speech). До 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`.

[← Озвучка](https://veselo.ai/docs/speech) · [Музыка →](https://veselo.ai/docs/music)

[Вся документация одним текстом](https://veselo.ai/docs/llms.txt) · [Все модели и цены](https://veselo.ai/models)

## Разделы документации

### Начало

- [Быстрый старт](https://veselo.ai/docs)
- [Ключи](https://veselo.ai/docs/auth)
- [Цены и списания](https://veselo.ai/docs/pricing)
- [Команды](https://veselo.ai/docs/teams)
- [Оплата для компаний](https://veselo.ai/docs/business)
- [Модели](https://veselo.ai/docs/models)

### Как сделать

- [Сообщения и параметры](https://veselo.ai/docs/chat)
- [Стриминг](https://veselo.ai/docs/streaming)
- [Вызов функций](https://veselo.ai/docs/tools)
- [Ответ в JSON](https://veselo.ai/docs/structured-output)
- [Провайдеры](https://veselo.ai/docs/providers)
- [Без цензуры](https://veselo.ai/docs/uncensored)
- [Картинки во входе](https://veselo.ai/docs/vision)
- [Картинки](https://veselo.ai/docs/images)
- [Видео](https://veselo.ai/docs/video)
- [Озвучка](https://veselo.ai/docs/speech)
- **Голоса**
- [Музыка](https://veselo.ai/docs/music)
- [Распознавание речи](https://veselo.ai/docs/transcriptions)
- [Эмбеддинги](https://veselo.ai/docs/embeddings)
- [Переранжирование](https://veselo.ai/docs/rerank)
- [SDK и программы](https://veselo.ai/docs/sdks)
- [Claude Code](https://veselo.ai/docs/anthropic)
- [Ключ для нейросети](https://veselo.ai/docs/agents)
- [MCP](https://veselo.ai/docs/mcp)

### Справочник

- [Методы API](https://veselo.ai/docs/reference)
- [Ошибки](https://veselo.ai/docs/errors)
- [Лимиты](https://veselo.ai/docs/limits)
- [Заголовки](https://veselo.ai/docs/headers)

### Ещё

- [Вопросы](https://veselo.ai/docs/faq)
- [Данные и приватность](https://veselo.ai/docs/privacy)
- [Изменения](https://veselo.ai/docs/changelog)
