Часто задаваемые вопросы
Какой URL endpoint для API?
Используйте POST-запрос к https://api.x365casino.com/v1/audio/speech. Отправляйте JSON-тело с текстом, голосом и форматом аудио. Это стандартный endpoint для синтеза речи, совместимый с инструментами, ожидающими структуру запроса как у OpenAI.
Как изменить базовый URL в SDK?
Укажите base_url как https://api.x365casino.com/v1 в настройках официального SDK OpenAI. Используйте ваш API-ключ для аутентификации. Это позволяет использовать стандартные методы SDK для отправки запросов на синтез аудио.
Поддерживает ли API потоковую передачу?
Нет, потоковая передача (streaming) или WebSocket не поддерживаются. Вы получаете готовый аудиофайл в ответе. Для коротких фраз генерация занимает несколько секунд, а длинные тексты обрабатываются последовательно, что может вызывать очереди при нагрузке.
Можно ли передать текст в формате JSON?
Текст передается внутри JSON-тела запроса в поле input. Сам запрос HTTP должен быть в формате JSON. Максимальная длина текста составляет 4096 символов. Превышение лимита требует разделения текста на части перед отправкой.
Какой статус код при успехе?
При успешном синтезе API возвращает аудиофайл в указанном формате (mp3, wav, opus, flac, pcm). HTTP-статус 200 OK. Тело ответа содержит бинарные данные аудиофайла.
Что делать при ошибке 429?
Код 429 означает превышение лимита: 60 запросов в минуту на ключ (или 10 до первого пополнения). Остановите отправку запросов на минуту или дождитесь обновления лимита. Повторите запрос позже, чтобы избежать дополнительных расходов.
Как обновить API-ключ?
Новый ключ можно выпустить в любой момент через личный кабинет. Старый ключ перестает действовать мгновенно. Используйте страницу /get-api-key/ для управления ключами и просмотра текущего баланса и статистики использования сервиса.
Где найти список доступных голосов?
Отправьте GET-запрос на endpoint /v1/voices. Там указаны все 8 доступных голосов, поддерживаемые языки, форматы и цены. Это позволяет программно интегрировать выбор голоса в интерфейс вашего приложения для анимации.
Можно ли передать язык явно?
Да, укажите поле language с ISO-кодом (например, ru, en). Если язык не задан, он определяется по скрипту, но латиница по умолчанию считается английской. Явное указание гарантирует корректное произношение для сложных языков.
Как обработать текст длиннее 4096 символов?
Разбейте текст на части по 4096 символов. Отправьте каждую часть отдельным запросом к API. Затем объедините полученные аудиофайлы в один файл. Это стандартный подход для создания длинных аудиодорожек для ваших мультфильмов.
Возвращает ли API метаданные запроса?
Сам ответ содержит аудиофайл. Метаданные запроса (время, символы, статус) сохраняются на стороне сервера для биллинга и отображаются в личном кабинете. Вы можете отслеживать расход символов и историю запросов через интерфейс сайта.
Есть ли у API версионирование?
Да, API использует префикс v1 в URL: /v1/audio/speech. Это позволяет обновлять эндпоинты, не ломая существующие интеграции. Используйте стабильную версию v1 для production-решений в ваших стартапах по анимации.
Как проверить работоспособность ключа?
Отправьте тестовый запрос на endpoint /v1/audio/speech с коротким текстом. Если ключ валиден, вы получите аудиофайл. Также проверьте баланс и статус ключа на странице /get-api-key/ в личном кабинете.
Можно ли использовать несколько ключей?
У аккаунта может быть один активный ключ. При выпуске нового старый сразу деактивируется. Это упрощает управление доступом. Для масштабирования используйте несколько аккаунтов или разделяйте нагрузку, выпуская ключи последовательно при необходимости.
Первый запрос
curl
curl https://api.x365casino.com/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3Python (openai)
from openai import OpenAI
client = OpenAI(base_url="https://api.x365casino.com/v1", api_key="tts-...")
with client.audio.speech.with_streaming_response.create(
model="tts-1", voice="nova", input="Hello from Python.", response_format="mp3"
) as response:
response.stream_to_file("hello.mp3")Node.js (openai)
import OpenAI from "openai";
import fs from "node:fs";
const client = new OpenAI({ baseURL: "https://api.x365casino.com/v1", apiKey: process.env.TTS_API_KEY });
const res = await client.audio.speech.create({ model: "tts-1", voice: "milo", input: "Hello from Node.js." });
fs.writeFileSync("hello.mp3", Buffer.from(await res.arrayBuffer()));| voice | |
|---|---|
aria | женский |
nova | женский |
luna | женский |
sage | женский |
felix | мужской |
milo | мужской |
atlas | мужской |
orion | мужской |
| language | |
|---|---|
ar | العربية |
zh | 中文 |
da | Dansk |
nl | Nederlands |
en | English |
fi | Suomi |
fr | Français |
de | Deutsch |
el | Ελληνικά |
he | עברית |
hi | हिन्दी |
it | Italiano |
ja | 日本語 |
ko | 한국어 |
ms | Bahasa Melayu |
no | Norsk |
pl | Polski |
pt | Português |
ru | Русский |
es | Español |
sw | Kiswahili |
sv | Svenska |
tr | Türkçe |
Быстрый старт
API позволяет автоматизировать озвучку анимационного контента и коротких роликов. Для начала работы необходимо получить ключ и отправить текст на синтез через простой HTTP-запрос.
Получение API-ключа
Зарегистрируйтесь на странице /get-api-key/, войдя через Google или создав аккаунт по email. Сразу после входа вы получите ключ формата tts-... и начальный баланс (0,50 $ для Google-аккаунтов).
Базовый curl-запрос
Отправляйте текст методом POST на https://api.x365casino.com/v1/audio/speech. Укажите заголовок Authorization: Bearer YOUR_KEY и параметры модели, голоса и формата аудио в теле запроса.
- Endpoint: POST /v1/audio/speech
- Auth: Bearer <ваш_ключ>
- Body: JSON с полями model, input, voice, response_format
Проверка баланса
Текущий статус аккаунта, доступные голоса и лимиты отображаются в личном кабинете. Баланс обновляется автоматически после успешного синтеза или пополнения USDT (TRC-20).
Использование SDK OpenAI
Используйте официальные SDK OpenAI для интеграции, изменив базовый URL на https://api.x365casino.com/v1. Это позволяет отправлять запросы стандартным методом, без необходимости писать собственный клиент.
Библиотека обрабатывает JSON-ответы и возвращает аудиофайл, который можно сразу сохранять или передавать в конвейер анимации. Поддерживается Python и другие языки SDK.
Установка библиотеки
Установите пакет через pip: pip install openai. Это стандартная библиотека, которая управляет HTTP-запросами и сериализацией данных.
Настройка base_url
Передайте base_url="https://api.x365casino.com/v1" при инициализации клиента. Это перенаправляет запросы на наш эндпоинт POST /v1/audio/speech, сохраняя совместимость с параметрами OpenAI.
Пример кода на Python
```python from openai import OpenAI client = OpenAI(base_url="https://api.x365casino.com/v1", api_key="tts-...") response = client.audio.speech.create( model="tts-1", voice="aria", input="Привет, это тестовый диалог для мультика." ) response.stream_to_file("output.mp3") ``` Код демонстрирует отправку текста и сохранение результата в файл MP3.
Форматы вывода аудио
API возвращает аудиофайл в выбранном формате сразу после завершения синтеза. Выбор формата зависит от этапа производственного пайплайна вашего стартапа: от мгновенной веб-интеграции до постобработки в профессиональных DAW.
MP3 для веб-интеграции
Оптимальный выбор для быстрого воспроизведения в браузерах и мобильных приложениях. Сжатие с потерями обеспечивает малый размер файлов при сохранении достаточного качества для коротких роликов и диалогов персонажей.
WAV для высокой точности
Используется на этапе монтажа для сохранения исходного качества без артефактов сжатия. Небольшой размер заголовка и отсутствие сжатия позволяют звукоинженерам точно накладывать эффекты на озвучку персонажей.
OPUS и FLAC для архивации
OPUS обеспечивает высокое качество при минимальном битрейте, что полезно для хранения длинных диалогов в облаке. FLAC предоставляет сжатие без потерь, сохраняя все детали голоса для будущих ремастров анимационного контента.
Параметры запроса
API принимает текст через поле input. Максимальная длина — 4096 символов, включая пробелы и знаки препинания. Для длинных сценариев разбивайте текст на части и объединяйте аудиофайлы.
Скорость воспроизведения настраивается параметром speed в диапазоне от 0.25 до 4.0. Это позволяет адаптировать темп речи под динамику анимационных сцен, от медленного повествования до быстрого диалога.
Поле input для текста
Передавайте текст в поле input. Символы подсчитываются вместе с пробелами и пунктуацией. Если язык не указан явно, система определяет его по скрипту, но для латиницы вне английского языка рекомендуется задавать язык вручную.
- Максимум 4096 символов за один запрос.
- Пробелы и знаки пунктуации учитываются в лимите.
Настройка скорости voice
Параметр speed позволяет ускорять или замедлять речь. Диапазон значений: от 0.25 до 4.0. Стандартная скорость — 1.0. Это полезно для синхронизации голоса с движением персонажей или создания комических эффектов.
- Минимальная скорость: 0.25.
- Максимальная скорость: 4.0.
Выбор модели tts-1 или tts-1-hd
Доступны две модели: tts-1 и tts-1-hd. Они используют один и тот же движок и имеют одинаковую стоимость. Выберите модель в зависимости от требуемого качества звука, хотя технически их функции идентичны.
- Модель tts-1.
- Модель tts-1-hd.
Обработка ошибок
При работе с API важно учитывать технические ограничения. Система обрабатывает запросы последовательно, поэтому при высокой нагрузке возможно ожидание в очереди. Это не является ошибкой, но влияет на время отклика.
Ошибка лимита запросов
Если вы превысите лимит в 60 запросов в минуту, API вернет ошибку. Для новых аккаунтов лимит составляет 10 запросов в минуту до первого пополнения.
- Повторите запрос через несколько секунд.
- Увеличьте лимит, пополнив баланс.
Неверный формат ввода
Текст должен быть строкой длиной не более 4096 символов. Если текст длиннее, разбейте его на части и объедините аудиофайлы на стороне клиента.
Возврат средств при сбое
Если синтез не удался, оплата за этот запрос возвращается в полном объеме. Это гарантирует, что вы платите только за успешную генерацию аудио.

Лимиты и ограничения
API имеет строгие технические границы, которые необходимо учитывать при проектировании конвейера генерации аудио. Лимиты настроены на обеспечение стабильности сервиса и справедливого распределения ресурсов между всеми клиентами платформы.
60 запросов в минуту
Максимальная пропускная способность составляет 60 запросов в минуту на один API-ключ. Это означает, что ваш бот может обрабатывать до 60 фрагментов текста за 60 секунд. При превышении этого лимита сервис вернёт ошибку, и запросы будут отклонены до снижения нагрузки.
Максимальная длина 4096 символов
Один запрос поддерживает текст длиной не более 4096 символов. Если сценарий анимации длиннее, необходимо разбить его на части, сгенерировать аудиофайлы для каждой и объединить их на стороне клиента. Пробелы и знаки препинания учитываются как символы.
Очередь обработки
Запросы обрабатываются последовательно. При высокой нагрузке на серверы генерации ваш запрос может попасть в очередь. Это может увеличить время отклика, особенно для сложных моделей или больших объёмов данных.
Аутентификация
Аутентификация в API обеспечивает безопасный доступ к сервису синтеза речи. Каждый запрос должен содержать валидный ключ, который идентифицирует ваш аккаунт и позволяет списывать средства за генерацию аудиофайлов.
Для отправки данных используется заголовок Authorization. Система проверяет токен на каждом эндпоинте, гарантируя, что только авторизованные клиенты могут инициировать процесс озвучки текста.
Заголовок Authorization
В HTTP-запросе обязательно укажите заголовок Authorization: Bearer <ваш-ключ>. Это стандартный метод передачи учётных данных в REST API, который работает с любыми HTTP-клиентами, включая библиотеки OpenAI.
- Используйте заголовок
Authorizationв каждом POST-запросе к/v1/audio/speech.
Формат Bearer-токена
Токен начинается с префикса Bearer и следует непосредственно за вашим секретным ключом. Пример: Authorization: Bearer tts-12345abcde. Убедитесь, что в токене нет лишних пробелов.
Ключ выглядит как строка, начинающаяся с tts-. Он уникален для вашего аккаунта и используется для идентификации при списании средств за каждый успешный запрос.
Один активный ключ
У каждого аккаунта есть только один активный ключ API. Если вы сгенерируете новый ключ в личном кабинете, предыдущий станет недействительным мгновенно. Это гарантирует, что доступ к сервису ограничен одним инструментом.
Вы можете выпустить новый ключ в любое время через раздел настроек. Старый ключ перестанет работать сразу после создания нового, поэтому обновите его в своих приложениях до смены.
- Один активный ключ на аккаунт.
Примеры интеграции
API позволяет автоматически генерировать аудиофайлы для анимационных проектов. Вы отправляете текст, а бот возвращает готовый аудиофайл в выбранном формате, что устраняет необходимость ручной записи дикторов.
Ниже приведены сценарии использования, демонстрирующие, как интегрировать синтез речи в рабочий процесс студии.
Генерация диалога
Используйте разные голоса для каждого персонажа. Например, назначьте 'aria' для главного героя и 'felix' для комического персонажа. Передавайте текст в JSON-запросе, указывая нужный голос в поле voice.
- Разные голоса для разных персонажей
- Быстрая смена тина диктора
- Автоматическая генерация реплик
Озвучка новостей
Для новостных вставок подходит голос 'atlas' — нейтральный и чёткий. API обрабатывает запросы последовательно, поэтому при большом объёме текста рекомендуется разбивать его на части до 4096 символов.
- Нейтральный тон для новостей
- Разбиение длинных текстов
- Последовательная обработка
Автоматизация контента
Интегрируйте API в CI/CD пайплайн. Скрипт может автоматически озвучивать сгенерированные сценарии и сохранять файлы. Это позволяет быстро создавать прототипы анимации без привлечения студии.
- Интеграция в CI/CD
- Автоматическая озвучка сценариев
- Экономия на студии
Послушайте 8 голосов
Каждый образец ниже сгенерирован этим API из одного и того же предложения. Ускорение полезно для динамичных сцен или коротких реплик, замедление — для эмоциональных монологов.
23 языка
Любой голос может говорить на любом из этих языков.
Источники и дополнительные материалы
- Wikipedia
- OpenAI API reference: create speech
- openai-python on GitHub
- Node.js documentation
- FFmpeg documentation
- openai-node on GitHub
- W3C WAI: making audio and video accessible
- Python documentation
- LibriVox public-domain audiobooks
- Creative Commons Attribution 4.0
- LibriTTS-R corpus (OpenSLR 141)
- LibriTTS-R paper (arXiv 2305.18802)
