Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
text | Да | The words to be spoken, exactly as written. Billed per 1,000 characters. |
pitch | Нет | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · По умолчанию: 0 |
speed | Нет | Темп речи. ≥ 0.5 · ≤ 2 · По умолчанию: 1 |
volume | Нет | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · По умолчанию: 1 |
language | Нет | Язык озвучки. zh · en · ja · es-mx · id · pt-br · ko · it · de · fr |
voice_id | Нет | Выберите один из доступных голосов. vivi_mixed_en_zh_ja_es_id · mindy_en_es_id_pt_zh · stokie_en · dacey_en · tim_en · kian_en_zh · cedric_en_zh · sophie_en_zh · jean_en_zh · magnus_en_zh · mabel_en_zh · nadia_en_zh · opal_en_zh · pearl_en_zh · quentin_en_zh · vienna_mixed_en_zh · alina_mixed_en_zh · corinne_mixed_en_zh · esther_mixed_en_zh · freya_mixed_en_zh · gigi_mixed_en_zh · holly_mixed_en_zh · lyla_mixed_en_zh · daisy_mixed_en_zh · tracy_es_zh · jess_ja_es_id_pt_en_zh · pinky_es_ko_mixed_en_zh · sweety_ja_es · sandy_es_mixed_en_zh · sven_de · minimi_ja · usseau_fr · felipe_es · han_id · martins_pt · enzo_it · shane_ko · bonnie_zh · felix_zh · celeste_zh · monkey_king_zh · По умолчанию: stokie_en |
sample_rate | Нет | Sample rate in Hz. The model uses 24000 when omitted. 8000–48000 |
instructions | Нет | How to read the text: tone, emotion, pace or volume. Not spoken and not billed. |
output_format | Нет | Формат файла результата. mp3 · opus · По умолчанию: mp3 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за 1000 символов | ≈ USD |
|---|---|---|
| Стандарт | 10,8 | 0,11 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 11 кредитов за 1000 символов (0,11 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Seed Speech 2.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seed-speech-2.0/text-to-speech и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seed-speech-2.0/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "stokie_en",
"output_format": "mp3"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Seed Speech 2.0
Сколько стоит API Seed Speech 2.0?
Seed Speech 2.0 стоит 11 кредитов (0,11 $) за 1000 символов. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Seed Speech 2.0 в API?
Укажите bytedance/seed-speech-2.0/text-to-speech — Озвучка текста в поле model запроса POST /jobs/createTask.
Как управлять подачей?
Выберите один из 41 готовых голосов через voice_id и опишите подачу в instructions — тон, эмоцию, темп или громкость, в одном-двух предложениях. Инструкции формируют чтение и не произносятся вслух.
Какие языки она читает?
Язык сценария определяется автоматически. С помощью language можно также принудительно задать китайский, английский, японский, мексиканский испанский, индонезийский, бразильский португальский, корейский, итальянский, немецкий или французский. Некоторые голоса рассчитаны более чем на один язык.
Может ли она скопировать голос реального человека?
Нет. На этом эндпоинте доступны только 41 готовых голосов; клонирования и загрузки эталонного голоса нет.
Какие ограничения у API Seed Speech 2.0?
Длина текста (символов): 5,000; Голоса: 41; Языки: 10. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Seed Speech 2.0 без кода?
Да. Playground запускает Seed Speech 2.0 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

