Облачный TTS API для автоматизации и ботов

Автор Редакция BotSpeech API · Обновлено 2026-11-19

Эта страница содержит исчерпывающее руководство по интеграции BotSpeech API в логику ваших чат-ботов и голосовых помощников. Вы узнаете, как получить API-ключ, настроить базовый URL для совместимости с SDK OpenAI и отправить первый запрос на синтез речи. Мы детально разберем структуру JSON-тела запроса, параметры моделей и доступные форматы аудио, чтобы вы могли быстро запустить генерацию звука в вашем приложении.

Руководство ориентировано на разработчиков стартапов и команд, которым нужен предсказуемый и быстрый текст в речь без лишних абстракций. Здесь описаны реальные рабочие процессы: от установки библиотеки OpenAI SDK до обработки ошибок и ограничений лимитов. Мы не предоставляем собственный SDK. Вы найдете готовые примеры кода на Python и JavaScript, а также пояснения по интеграции голосовых модулей в логические цепочки ваших приложений, начиная с базовых параметров и заканчивая нюансами безопасности ключа.

Облачный TTS API для автоматизации и ботов

Часто задаваемые вопросы

Как получить ключ 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.mp3

Python (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中文
daDansk
nlNederlands
enEnglish
fiSuomi
frFrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
itItaliano
ja日本語
ko한국어
msBahasa Melayu
noNorsk
plPolski
ptPortuguês
ruРусский
esEspañol
swKiswahili
svSvenska
trTürkçe

Получение ключа API

Иллюзация звуковой волны для: Получение ключа 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

Иллюзация звуковой волны для: Использование 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 из одного и того же предложения. Это снижает порог входа для разработчиков стартапов, которым важна скорость вывода продукта на рынок.

Аватар голоса aria
ariaженский
Аватар голоса nova
novaженский
Аватар голоса luna
lunaженский
Аватар голоса sage
sageженский
Аватар голоса felix
felixмужской
Аватар голоса milo
miloмужской
Аватар голоса atlas
atlasмужской
Аватар голоса orion
orionмужской

23 языка

Любой голос может говорить на любом из этих языков.

Источники и дополнительные материалы

  1. Wikipedia
  2. W3C WAI: making audio and video accessible
  3. openai-python on GitHub
  4. TRON developer hub: TRC-20
  5. Node.js documentation
  6. LibriTTS-R paper (arXiv 2305.18802)
  7. IETF RFC 7845: Ogg Opus
  8. Creative Commons Attribution 4.0
  9. OpenAI API reference: create speech
  10. LibriVox public-domain audiobooks
  11. ISO 639 language codes
  12. Tether (USDT)

Больше на этом сайте