Введение
Отправьте до 1000 символов английского текста и, по желанию, насколько выразительным, разнообразным и точно направленным должно быть чтение. Задача возвращает один файл WAV (24 кГц, 16 бит, моно), прочитанный встроенным голосом Chatterbox или голосом короткого фрагмента, отправленного в reference_audio_url. Теги вроде зачитываются вслух, поэтому вместо них записывайте звуки по буквам. SpicyAPI не применяет фильтр контента: сценарии без фильтров читаются так, как написаны. Каждый запрос стоит одну и ту же фиксированную цену.
| Характеристика | Значение |
|---|---|
| Ввод | Текст |
| Вывод | Аудио |
| Обязательное поле | text — от 1 до 1000 символов на английском |
| Необязательные поля | exaggeration (0–1), temperature (0,05–2), |
| Результат | Один файл WAV, 24 кГц, 16 бит, моно |
| Голос | Встроенный голос или клон из |
| Тарифицируемое количество | Фиксированная цена за запрос |
| Хранение | Сгенерированный звук хранится 14 дней |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
text | Да | До 1000 символов английского текста, читаемых в точности как написано. Теги вроде зачитываются вслух; вместо них записывайте звуки по буквам. Не менее 1 символов · Не более 1000 символов |
reference_audio_url | Нет | Необязательный фрагмент MP3 или WAV с голосом, который нужно повторить: загрузите его или укажите публичный URL. Не менее 1 символов |
exaggeration | Нет | Насколько эмоционально звучит чтение, от 0 (ровно) до 1 (драматично). По умолчанию: 0,5. |
temperature | Нет | Вариативность между дублями, от 0,05 до 2. По умолчанию: 0,7. |
guidance_scale | Нет | Насколько точно чтение следует естественному темпу текста, от 0,1 до 1. По умолчанию: 0,5; понизьте значение, чтобы замедлить торопливое чтение. |
Стоимость
$0.036 / запрос
Фиксированная цена за запрос на до 1000 символов.
Сценарии использования
Реплики для игр и анимации
Короткие, яркие реплики персонажей, где энергия важнее выбора тембра. Повышайте exaggeration для криков, смеха или реплик, произносимых на одном дыхании.
Прототипы голосов
Озвучьте демо, раскадровку или чат-бота, прежде чем выберете окончательный голос, по фиксированной цене за реплику.
Аудиоистории без цензуры
Сценарии без фильтров читаются так, как написаны. В наших тестах модель озвучивала каждое слово отправленных монологов и повествования, в том числе звуки, записанные словами.
Голосовые дорожки для видео
Сгенерируйте реплику здесь, а затем передайте WAV модели говорящего аватара или синхронизации губ, чтобы её озвучило лицо на экране.
Руководство по промптам и практические советы
Отправьте сценарий текстом
До 1000 символов английского текста, с пунктуацией для пауз. Пишите смех и вздохи словами: теги читаются вслух.
Настройте энергию
По умолчанию exaggeration равен 0,5. Повышайте его для драматичных или задыхающихся реплик, понижайте для спокойного повествования.
При необходимости настройте точнее
Понизьте
guidance_scale, чтобы замедлить торопливое чтение; повышьте temperature для большей вариативности между дублями.
Что возвращается
Один файл WAV на задачу: 24 кГц, 16 бит, моно PCM. Файл копируется в хранилище SpicyAPI и хранится 14 дней. Результат не содержит пословных таймингов или субтитров.
Голос
Chatterbox — это англоязычная модель с открытым исходным кодом от Resemble AI (лицензия MIT). Без эталона он читает встроенным голосом; списка голосов нет. Отправьте в reference_audio_url короткий фрагмент MP3 или WAV, чтобы клонировать голос: чтение перенимает тембр фрагмента, а не его слова. Лучше всего подходят несколько секунд одного чистого голоса без музыки, и на голос у вас должны быть права.
Настройки
exaggeration(0–1, по умолчанию 0,5): насколько эмоционально звучит чтение.temperature(0,05–2, по умолчанию 0,7): вариативность между дублями.guidance_scale(0,1–1, по умолчанию 0,5): насколько точно чтение следует темпу текста; значение около 0,3 замедляет быструю, драматичную подачу.
В наших тестах теги вроде <laugh>, <sigh> или [gasp] зачитывались вслух как обычные слова. Вместо этого записывайте звуки по буквам: «ha…», «mmm…», «ahh…».
Длина
text принимает до 1000 символов. В наших тестах абзац из 270 символов превращался примерно в 15 секунд аудио; большинство задач завершалось за 10–30 секунд.
Тарификация
Фиксированная цена за запрос. Неудачные запросы не тарифицируются.
Контент
SpicyAPI не добавляет никакого контент-фильтра. В наших тестах сценарии без фильтров читались дословно, ничего не пропускалось и ни один клип не обрывался раньше времени.
SpicyAPI не добавляет фильтр контента: сценарии читаются так, как написаны, без какого-либо смягчения. Вы несёте ответственность за отправляемые сценарии и за то, как вы используете полученный звук, включая недопустимость выдавать его за слова реального человека.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "resemble-ai/chatterbox-v1/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download."
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
