Часто задаваемые вопросы
Как получить ключ API?
Зарегистрируйтесь на странице /get-api-key/ через Google или email. После входа вы получите уникальный ключ формата tts-... и доступ к панели управления. Ключ можно сгенерировать заново в любой момент, при этом старый перестает действовать мгновенно. Баланс и статистика использования отображаются в личном кабинете.
Какой URL для запросов?
Используйте конечную точку POST https://api.j2000.info/v1/audio/speech. Для отправки текста и получения аудиофайла отправляйте JSON-запрос на этот адрес. Убедитесь, что заголовок Authorization содержит ваш Bearer-токен. Все запросы обрабатываются последовательно, поэтому при высокой нагрузке может возникнуть очередь.
Можно ли использовать OpenAI SDK?
Да, формат запроса идентичен OpenAI. Просто измените base_url в SDK на https://api.j2000.info/v1 и укажите ваш ключ. Это позволяет использовать готовые библиотеки без переписывания кода. Другие конечные точки, такие как /v1/voices, доступны для получения списка голосов и форматов.
Какие модели доступны?
Доступны две модели: tts-1 и tts-1-hd. Обе используют один и тот же движок синтеза и имеют одинаковую стоимость. Выбор модели не влияет на качество или цену, поэтому вы можете использовать любую из них в зависимости от предпочтений в коде вашего приложения.
Какие голоса можно выбрать?
Доступно 8 предустановленных голосов: Aria, Nova, Luna, Sage (женские) и Felix, Milo, Atlas, Orion (мужские). Каждый голос имеет уникальный тембр, подходящий для разных сценариев: от новостей до сторителлинга. Вы можете выбрать любой голос из списка, доступного через GET /v1/voices.
Какие форматы аудио поддерживаются?
API поддерживает форматы mp3, wav, opus, flac и pcm. Выберите подходящий формат в поле response_format в зависимости от требований вашего приложения. MP3 оптимален для экономии трафика, а WAV или FLAC обеспечивают высокое качество. PCM подходит для прямой обработки аудиопотока.
Какой лимит запросов в минуту?
Лимит составляет 60 запросов в минуту на один ключ API. До первого пополнения баланса лимит ниже — 10 запросов в минуту. Если вы превысите лимит, запросы могут обрабатываться с задержкой. Рекомендуем мониторить использование в панели управления для стабильной работы ваших ботов.
Сколько символов в одном запросе?
Максимальный объем текста в одном запросе составляет 4096 символов. Если ваш текст длиннее, разделите его на части и отправляйте последовательно. Затем вы можете объединить полученные аудиофайлы в своем приложении. Это стандартный подход для интеграции с длинными сценариями диалогов.
Что делать при ошибке?
Если синтез не удался, оплата возвращается в полном объеме. Проверьте корректность входных данных и доступность ключа. Если проблема сохраняется, обратитесь в поддержку по электронной почте. Мы не гарантируем время отклика и не предоставляем SLA.
Где найти документацию?
Полная документация доступна на этой странице и в разделе /docs/. Вы также можете получить список доступных голосов и форматов через GET /v1/voices. Примеры запросов, включая curl, отображаются в личном кабинете после регистрации. Используйте эти ресурсы для быстрой интеграции в ваш проект.
Можно ли изменить скорость?
Да, параметр speed позволяет регулировать скорость от 0.25 до 4.0. Это полезно для адаптации речи под разные сценарии использования в чат-ботах. Увеличение скорости ускоряет генерацию. Настройте параметр в зависимости от требований вашего пользовательского интерфейса.
Как указать язык?
Передайте код языка (ISO) в поле language. Если поле не указано, язык определяется автоматически по скрипту текста (латиница по умолчанию — английский). Для точного распознавания неанглийских текстов на латинице обязательно указывайте язык явно. Поддерживается 23 языка, включая русский, английский и китайский. Не поддерживаются вьетнамский, индонезийский, тайский, украинский, румынский, чешский, бенгальский и другие.
Что такое watermark?
Каждый сгенерированный аудиофайл содержит неслышимый цифровой водяной знак, указывающий на его синтетическое происхождение. Это помогает идентифицировать речь, созданную нашим API. Водяной знак встроен в аудио и не влияет на качество восприятия пользователем. Он присутствует во всех файлах, созданных через наш сервис.
Как работает авторизация?
Используйте заголовок Authorization: Bearer tts-<ваш-ключ>. Один аккаунт имеет один активный ключ. Вы можете выпустить новый ключ в любой момент через панель управления; старый станет недействительным мгновенно. Убедитесь, что ключ передается корректно в каждом HTTP-запросе к API.
Первый запрос
curl
curl https://api.j2000.info/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.j2000.info/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.j2000.info/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
Для начала работы с BotSpeech API вам потребуется активный ключ. Регистрация доступна на странице /get-api-key/ через Google или по email. Ключ привязан к конкретному сайту сети, поэтому учетные записи не являются глобальными.
После создания аккаунта вы получите уникальный токен для аутентификации. Один ключ позволяет сделать до 60 запросов в минуту. При необходимости старый ключ можно мгновенно заменить новым.
Регистрация аккаунта
Перейдите на страницу /get-api-key/ и авторизуйтесь через Google или создайте аккаунт по email и паролю. Учетные записи создаются отдельно для каждого сайта сети. Если вы вошли через Google, вам автоматически начисляется пробный кредит $0.50 на 7 дней.
Где найти ключ
После входа на страницу аккаунта отобразится ваш текущий API-ключ в формате tts-.... Также здесь доступны данные о балансе, пробном периоде и количестве использованных символов. Ключ можно скопировать для использования в коде.
На странице также доступен готовый пример команды curl для быстрой проверки работоспособности ключа.
Использование ключа
Передавайте ключ в заголовке Authorization: Bearer tts-... каждого HTTP-запроса к API. Один аккаунт может иметь только один активный ключ одновременно. Если выпустить новый, предыдущий перестанет действовать мгновенно.
Ключ позволяет доступ к эндпоинтам /v1/audio/speech, /v1/voices и /v1/models. Убедитесь, что ключ хранится в переменных окружения вашего бота или сервиса.
- Формат ключа:
tts-... - Один активный ключ на аккаунт
- Мгновенная инвалидация старого ключа при выпуске нового
Первый запрос
Чтобы проверить работу API, отправьте POST-запрос на endpoint https://api.j2000.info/v1/audio/speech. Это базовый способ получить аудиофайл, не зависящий от конкретных языков программирования.
Команда curl
Используйте следующую команду для отправки запроса. Замените YOUR_API_KEY на ваш ключ из личного кабинета.
- curl -X POST https://api.j2000.info/v1/audio/speech
- -H "Authorization: Bearer YOUR_API_KEY"
- -H "Content-Type: application/json"
- -d '{"model": "tts-1", "input": "Привет, мир!", "voice": "nova"}'
Тело запроса
В теле запроса передайте JSON с полями model, input и voice. Поддерживаются модели tts-1 и tts-1-hd. Текст ограничен 4096 символами.
Ответ сервера
При успешном выполнении сервер вернет аудиофайл в указанном формате (mp3, wav, opus, flac или pcm). Если синтез не удался, вы получите код ошибки, а стоимость будет возвращена в полном объеме.
Использование OpenAI SDK
Используйте SDK OpenAI для Python, так как наш API совместим с его структурой запросов. Это позволяет применять привычный интерфейс без написания собственной логики HTTP-клиентов.
Установка библиотеки
Установите пакет через pip. Это стандартный способ подключения для большинства проектов на Python.
- pip install openai
Настройка base_url
Укажите базовый URL вашего API вместо стандартного. Это переопределит адрес сервера для всех запросов SDK.
Пример кода
Инициализируйте клиент с вашим ключом и новым адресом. Отправьте текст через метод audio.speech.
- from openai import OpenAI
- client = OpenAI(base_url="https://api.j2000.info/v1", api_key="tts-...")
- response = client.audio.speech.create(...)
Параметры запроса
API поддерживает две модели синтеза речи: tts-1 и tts-1-hd. Обе используют один и тот же движок, поэтому качество аудио и стоимость запроса полностью идентичны. Выбор модели влияет только на имя параметра в запросе, позволяя легко переключаться между версиями при необходимости.
Модели озвучивания
Параметр model принимает значения tts-1 или tts-1-hd. Несмотря на разные названия, оба варианта генерируют звук с одинаковой скоростью и ценой за символ. Это упрощает тестирование: вы можете выбрать модель по имени в коде без изменения логики обработки ответа.
Голоса
Доступно 8 предустановленных голосов с разными тембрами: от спокойного sage до энергичного felix. Каждый голос может произносить любой из 23 поддерживаемых языков, включая русский, английский, китайский и немецкий. Мы не поддерживаем вьетнамский, индонезийский, тайский, украинский, румынский, чешский, бенгальский и другие языки. Параметр voice принимает имя голоса (например, nova или atlas).
- Женские: aria, nova, luna, sage
- Мужские: felix, milo, atlas, orion
- Язык указывается через параметр
languageили определяется автоматически
Форматы аудио
Вы можете выбрать формат выходного файла через параметр response_format. Поддерживаются MP3, WAV, OPUS, FLAC и PCM. Выбор зависит от требований вашего приложения: MP3 экономит трафик, а WAV обеспечивает прямое воспроизведение без дополнительной конвертации.
Ограничения и лимиты
API имеет строгие лимиты для стабильной работы. Ключ ограничен 60 запросами в минуту, до первого пополнения — 10 запросами/мин. Превышение лимита блокирует новые запросы до истечения окна.
Лимит запросов
Максимум 60 запросов в минуту на один ключ. До первого пополнения лимит составляет 10 запросов в минуту. Превышение приводит к временной блокировке.
Длина текста
Один запрос обрабатывает текст до 4096 символов. Для длинных сообщений необходимо разбивать текст на части и объединять аудиофайлы.
Очереди
Запросы обрабатываются последовательно. При высокой нагрузке новые запросы могут ожидать в очереди, увеличивая время ответа.

Обработка ошибок
API возвращает стандартные HTTP-коды состояния. Понимание ответов сервера позволяет корректно обрабатывать сбои и избегать потери данных в логических цепочках вашего бота.
Ключи защищеныBearer-токеном. При необходимости вы можете выпустить новый ключ в личном кабинете, что мгновенно отключает старый, обеспечивая безопасность доступа.
Коды ошибок
Сервер возвращает 200 при успехе. Коды 4xx указывают на проблемы с запросом (например, неверный ключ), а 5xx — на временные сбои на стороне API.
- 401 Unauthorized: неверный или истёкший API-ключ.
- 429 Too Many Requests: превышен лимит 60 запросов в минуту.
- 400 Bad Request: ошибка в структуре JSON или параметрах.
Повторные запросы
При ошибке 429 реализуйте экспоненциальную задержку перед повторной попыткой. Это предотвратит перегрузку очереди, так как запросы обрабатываются последовательно.
- Ошибки 400 не требуют повторной отправки с теми же данными.
- При 500–503 ожидания 1–2 секунд обычно достаточно для восстановления.
Безопасность ключа
Храните ключ в переменных окружения, а не в коде клиента. Если ключ скомпрометирован, немедленно выпустите новый в разделе аккаунта: старый перестанет действовать мгновенно.
Форматы аудио
Выбор формата аудио влияет на размер файла и совместимость с медиаплеерами ваших ботов. Мы поддерживаем пять форматов: MP3, WAV, OPUS, FLAC и PCM.
MP3
Самый популярный формат для веб-интеграций и мобильных приложений. MP3 обеспечивает хорошее соотношение качества и размера файла, что снижает нагрузку на каналы связи при воспроизведении коротких фраз.
WAV
Некомпрессированный формат с оригинальным качеством звука. Идеален для систем, требующих максимального качества без артефактов сжатия, или для последующей обработки аудио в редакторах.
Другие форматы
OPUS обеспечивает высокую сжимаемость при сохранении разборчивости речи, что полезно для экономии трафика. FLAC предлагает сжатие без потерь для архивации. PCM возвращает сырой аудио поток без заголовков.
- MP3: универсальное решение
- WAV: высокое качество
- OPUS: экономия трафика
- FLAC: без потерь
- PCM: сырой поток
Примеры интеграции
Интеграция BotSpeech API в логические цепочки ботов требует минимальных изменений в коде. Ниже приведены рабочие примеры для популярных языков и сценариев использования.
Код готов к копированию. Убедитесь, что переменная API_KEY содержит ваш реальный токен из личного кабинета.
Python скрипт
Используйте стандартную библиотеку requests. Отправьте POST-запрос на https://api.j2000.info/v1/audio/speech. Обработайте бинарный ответ и сохраните файл.
- Установите библиотеку:
pip install requests - Передайте JSON с полями
model,input,voice - Сохраните
response.contentв файл.mp3или.wav
JavaScript пример
Используйте fetch для отправки запроса. Установите заголовок Authorization: Bearer <ваш_ключ>.
- Укажите
base_url: 'https://api.j2000.info/v1' - Парсите JSON-тело с текстом и параметрами голоса
- Сохраните бинарный ответ в файл
Встраивание в бота
Для Telegram или Discord вызывайте API при получении команды. Генерируйте аудиофайл и отправляйте его как документ или голосовое сообщение.
- Обработайте входящий текст
- Отправьте запрос на синтез
- Загрузите результат в чат
Послушайте 8 голосов
Каждый образец ниже сгенерирован этим API из одного и того же предложения. Это снижает порог входа для разработчиков стартапов, которым важна скорость вывода продукта на рынок.
23 языка
Любой голос может говорить на любом из этих языков.
Источники и дополнительные материалы
- Wikipedia
- W3C WAI: making audio and video accessible
- openai-python on GitHub
- TRON developer hub: TRC-20
- Node.js documentation
- LibriTTS-R paper (arXiv 2305.18802)
- IETF RFC 7845: Ogg Opus
- Creative Commons Attribution 4.0
- OpenAI API reference: create speech
- LibriVox public-domain audiobooks
- ISO 639 language codes
- Tether (USDT)
