Часто задаваемые вопросы
Как получить ключ API?
Зарегистрируйтесь на странице /get-api-key/ через Google или email. После входа вы увидите ключ, баланс и примеры. Ключ начинается на tts-... и используется в заголовке Authorization. Вы можете выпустить новый ключ в любой момент, старый перестанет действовать мгновенно.
Какие модели доступны?
Доступны две модели: tts-1 и tts-1-hd. Они используют один и тот же движок и стоят одинаково. Выберите нужную модель в поле request body. Разница только в качестве аудио, но для большинства задач онлайн-образования обе модели полностью покрывают потребности.
Можно ли использовать OpenAI SDK?
Да, формат запросов идентичен OpenAI. Просто измените base_url на https://api.6230.info/v1 и используйте свой ключ GolosLector. Это позволяет быстро интегрировать синтез в ваши LMS без написания сложного кода с нуля, экономя время на настройку.
Какие форматы аудио поддерживаются?
API поддерживает mp3, wav, opus, flac и pcm. Укажите желаемый формат в поле response_format. Для интеграции с популярными LMS обычно достаточно mp3 или wav. Формат выбирается в теле запроса POST /v1/audio/speech вместе с текстом и голосом.
Как указать язык?
Передайте ISO-код языка в поле language. Если поле не указано, язык определяется по скрипту (латиница по умолчанию — английский). Для точного результата всегда указывайте язык явно, особенно для неанглийских текстов на латинице. Поддерживается 23 языка, включая русский и английский.
Какой лимит запросов в минуту?
Лимит составляет 60 запросов в минуту на один ключ. До первого пополнения баланса лимит ниже — 10 запросов в минуту. Это позволяет обрабатывать пачки аудио для курсов без перегрузки. При высокой нагрузке запросы могут стоять в очереди.
Что делать при ошибке запроса?
Проверьте структуру JSON и доступность ключа. Убедитесь, что текст не превышает 4096 символов. Если ошибка сохраняется, свяжитесь с нами по email. Поддержка осуществляется только по электронной почте. Логи запросов сохраняются для диагностики.
Возвращаются ли средства при ошибке?
Да, при сбое синтеза средства возвращаются в полном объеме. Вы платите только за успешные запросы. Баланс не истекает, а кредит пробного периода (0,50$) действует 7 дней. Остаток средств можно пополнить через USDT (TRC-20).
Первый запрос
curl
curl https://api.6230.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.6230.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.6230.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-ключа
Начните работу с API, перейдя на страницу /get-api-key/ и зарегистрировавшись через Google или по email. После входа вы увидите свой активный ключ API, баланс и готовые примеры запросов.
В системе поддерживается только один активный ключ на аккаунт. Это упрощает управление доступом и гарантирует предсказуемость лимитов при интеграции в ваши LMS.
Регистрация через Google или email
Создайте аккаунт на странице /get-api-key/, выбрав авторизацию через Google или стандартную регистрацию по email и паролю. Это займет всего пару минут, после чего вы сразу получите доступ к панели управления ключом и статистикой.
Генерация нового ключа
Вы можете сгенерировать новый API-ключ в любой момент через личный кабинет. Новая версия ключа активируется мгновенно, что позволяет быстро реагировать на изменения в команде разработчиков.
Одновременная работа одного ключа
Одновременно работает только один ключ. При создании нового предыдущий ключ прекращает действие сразу же. Это исключает конфликты версий при обновлении доступа.
Первый запрос через cURL
Для начала работы отправьте POST-запрос на эндпоинт https://api.6230.info/v1/audio/speech. Тело запроса содержит текст до 4096 символов, выбранный голос и формат вывода. Это стандартный формат, совместимый с библиотеками OpenAI.
Авторизация осуществляется через заголовок Authorization: Bearer с вашим уникальным ключом. Убедитесь, что ключ начинается с tts-. Сервер вернет аудиофайл в указанном формате или код ошибки, если синтез не удался.
Структура JSON-тела запроса
Отправляйте данные в формате JSON. Обязательные поля: model (выберите tts-1 или tts-1-hd), input (ваш текст) и voice (например, nova или atlas). Можно также указать response_format (mp3, wav, opus, flac, pcm) и speed в диапазоне от 0.25 до 4.0.
Если текст превышает лимит в 4096 символов, разбейте его на части, обработайте отдельно и склейте файлы на стороне клиента. Поле language можно указать кодом ISO, иначе язык определяется автоматически по скрипту.
model: "tts-1" или "tts-1-hd" (одинаковая цена и движок)input: текст длиной до 4096 символовvoice: один из 8 предустановленных голосовresponse_format: mp3, wav, opus, flac, pcm
Заголовок авторизации
В заголовке Authorization укажите токен доступа в формате Bearer <ваш_ключ>. У каждого аккаунта есть один активный ключ. Если вы сгенерируете новый, старый перестанет действовать мгновенно.
Проверяйте корректность ключа на странице /get-api-key/. Использование недействительного токена вернет ошибку 401 Unauthorized.
Обработка ответа сервера
При успешном выполнении сервер возвращает аудиофайл в запрошенном формате. Если синтез завершился ошибкой, средства возвращаются в полном объеме.
Учитывайте, что обработка запросов происходит последовательно. В периоды высокой нагрузки возможно ожидание в очереди, поэтому закладывайте время на генерацию для крупных текстов.
Интеграция с OpenAI SDK
Интеграция с нашим API через библиотеку OpenAI SDK значительно упрощает внедрение синтеза речи в ваши продукты для онлайн-образования. Вам не нужно разрабатывать собственный клиент или разбираться в специфике наших эндпоинтов — достаточно изменить базовый URL.
Стандартные методы SDK, такие как client.audio.speech, работают нативно. Это позволяет стартапам сосредоточиться на логике LMS, а не на настройке голосовых движков. Мы сохраняем совместимость с официальными клиентами OpenAI, меняя лишь адрес сервера.
Изменение base_url
Для начала работы укажите базовый URL нашего API в конфигурации SDK. Это единственное необходимое изменение для перенаправления запросов на наши сервера генерации аудио.
base_url = "https://api.6230.info/v1"
Использование стандартных методов
Используйте знакомый метод Audio.speech(), передавая текст, голос и формат. Структура параметров полностью соответствует спецификации OpenAI, что гарантирует предсказуемость поведения в вашем коде.
Пример кода на Python
Вот минимальный пример инициализации клиента и генерации аудиофайла. Убедитесь, что вы установили пакет openai и передали свой API-ключ через переменную окружения или параметр api_key.
Технические параметры запроса
API принимает запросы через POST к https://api.6230.info/v1/audio/speech. Вы выбираете модель «tts-1» или «tts-1-hd» (одинаковый движок и цена), указывая текст до 4096 символов и один из 8 голосов.
Поддерживаемые модели и голоса
Доступны две модели: «tts-1» и «tts-1-hd». Они используют один и тот же движок синтеза и тарифицируются одинаково. Выбор зависит только от требуемого качества аудио.
- tts-1: базовая модель
- tts-1-hd: высокое качество
- 8 голосов: aria, nova, luna, sage, felix, milo, atlas, orion
Форматы выходного аудио
Вы можете получить результат в форматах mp3, wav, opus, flac или pcm. Выбор формата зависит от потребностей вашей LMS и плееров, которые используют ваши студенты.
Настройка скорости и языка
Параметр скорости регулируется в диапазоне от 0.25 до 4.0. Язык можно указать кодом ISO или доверить автоопределение. Если язык не задан, система пытается угадать его по скрипту.
Лимиты и тарификация
Тариф фиксированный: 10 долларов за миллион символов (или $0,01 за 1000 символов). Пробелы и знаки препинания учитываются как полные символы. Ошибки синтеза бесплатны — если генерация не удалась, средства возвращаются в полном объеме.
Лимит составляет 60 запросов в минуту на ключ (10 до первого пополнения). Запросы обрабатываются последовательно, поэтому под нагрузкой возможна очередь. Оплата принимается только в USDT (сеть TRON, TRC-20), минимум $5.
Тариф и стоимость символов
Стоимость генерации составляет $0,01 за 1000 символов. В подсчет включаются все пробелы и пунктуация. Если синтез завершился ошибкой, средства возвращаются в полном объеме.
Лимиты запросов в минуту
Доступно 60 запросов в минуту на один активный ключ. До первого пополнения баланса лимит снижен до 10 запросов в минуту. Обработка идет последовательно, поэтому при высокой нагрузке запросы могут стоять в очереди.
Оплата через USTRC20
Мы принимаем только USDT в сети TRON (TRC-20). Минимальная сумма пополнения — $5. Баланс зачисляется автоматически в течение нескольких минут после перевода. Подписок и комиссий нет.
- Сеть: TRON (TRC-20)
- Минимальный депозит: $5
- Зачисление: автоматическое, за минуты

Особенности генерации аудио
Генерация аудио — это не мгновенный процесс, а последовательная обработка данных. Понимание технических ограничений поможет вам правильно спроектировать интеграцию в ваш LMS и избежать задержек при массовом создании курсов.
Длина текста и разбивка
Максимальная длина входного текста ограничена 4096 символами за один запрос. Если ваш сценарий или лекция длиннее, необходимо разбить текст на части, сгенерировать аудиофайлы для каждой и склеить их.
Скорость генерации
Средняя скорость синтеза составляет около 25 символов текста в секунду аудиозаписи, что соответствует реальному времени воспроизведения. Короткие фразы генерируются за несколько секунд, но запросы обрабатываются последовательно, поэтому под нагрузкой возможна очередь.
Водяные знаки в файлах
Каждый сгенерированный аудиофайл содержит невидимый цифровой водяной знак, подтверждающий его синтетическое происхождение. Это техническая особенность движка, не влияющая на качество восприятия слушателями.
Доступные языки и голоса
Наш API поддерживает 23 языка, включая английский, русский, китайский, испанский и другие. Любой из восьми голосов может воспроизводить любой из этих языков, что упрощает локализацию курсов без необходимости подбирать отдельные модели для каждой аудитории.
Голоса основаны на лицензированных записях LibriTTS-R (CC BY 4.0) и аудиокнигах LibriVox (общественное достояние). Это гарантирует высокое качество звучания и юридическую чистоту контента для ваших образовательных продуктов.
Список из 23 языков
API поддерживает широкий спектр языков для глобальных образовательных стартапов. Поддерживаемые языки: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish.
- Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish
8 предустановленных голосов
Выбирайте голос под стиль вашего курса. Женские голоса: Aria (теплый), Nova (энергичный), Luna (мягкий), Sage (спокойный). Мужские голоса: Felix (динамичный), Milo (дружелюбный), Atlas (нейтральный), Orion (глубокий). Каждый файл содержит невидимый водяной знак, подтверждающий синтетическое происхождение аудио.
- Aria, Nova, Luna, Sage, Felix, Milo, Atlas, Orion
Автоопределение языка
Если поле language не указано, система определит язык по скрипту (латиница по умолчанию — английский). Для текстов на других латиницей рекомендуем явно указывать язык. Языки, не поддерживаемые API: Vietnamese, Indonesian, Thai, Ukrainian, Romanian, Czech, Bengali и другие.
Часто задаваемые вопросы по API
API GolosLector прост в использовании: отправьте текст, получите аудиофайл. Ниже собраны ответы на ключевые технические вопросы, которые помогут вам быстрее интегрировать синтез речи в ваш продукт без лишних настроек сложных движков.
Мы используем стандартные подходы, чтобы вы могли сосредоточиться на развитии курсов, а не на отладке интеграции.
Как получить ключ API?
Зарегистрируйтесь на странице /get-api-key/, используя Google или email. После входа вы увидите свой уникальный ключ, баланс и пример команды cURL.
Какие модели доступны?
Доступны две модели: «tts-1» и «tts-1-hd». Они используют один и тот же движок генерации и имеют одинаковую стоимость, но предлагают разное качество аудио.
Можно ли использовать OpenAI SDK?
Да. Поскольку структура запросов идентична, вы можете использовать официальные SDK OpenAI, просто изменив параметр base_url на https://api.6230.info/v1.
Какие форматы аудио поддерживаются?
Вы можете выбрать mp3, wav, opus, flac или pcm в поле response_format запроса. Это позволяет гибко подбирать формат под требования вашей LMS.
Как указать язык?
Передайте ISO-код языка в поле language. Если поле не указано, язык определяется автоматически по скрипту (латиница по умолчанию — английский). Для точности настраивайте язык явно.
Какой лимит запросов в минуту?
Лимит составляет 60 запросов в минуту на один ключ (до первого пополнения — 10 в минуту). Запросы обрабатываются последовательно.
Что делать при ошибке запроса?
Проверьте статус-код ответа. При ошибке синтеза средства возвращаются полностью, и вы можете повторить запрос или разбить текст.
Возвращаются ли средства при ошибке?
Да, при сбое синтеза сумма списывается обратно на ваш баланс автоматически. Это позволяет безопасно тестировать интеграцию.
Послушайте 8 голосов
Каждый образец ниже сгенерирован этим API из одного и того же предложения. Мы берём на себя сложность движка, чтобы вы могли сосредоточиться на развитии продукта, а не на настройке голосовых модулей.
23 языка
Любой голос может говорить на любом из этих языков.
