Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
text | Да | The words to be spoken, exactly as written. Billed per 1,000 characters, minimum 100. |
language | Нет | Язык озвучки. auto · zh · en · de · fr · es · it · pt · ru · ja · ko · По умолчанию: auto |
voice_id | Нет | Выберите один из доступных голосов. Serena · Vivian · Uncle_Fu · Dylan · Eric · Ryan · Aiden · Ono_Anna · Sohee · По умолчанию: Serena |
instructions | Нет | How to read the text: tone, emotion or pace. Not spoken and not billed. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за 1000 символов | ≈ USD |
|---|---|---|
| Стандарт | 10,2 | 0,10 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 11 кредитов за 1000 символов (0,11 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Qwen3 TTS в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/qwen-3-tts/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": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "Serena",
"language": "auto"
}
}'
# 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 Qwen3 TTS
Сколько стоит API Qwen3 TTS?
Qwen3 TTS стоит 11 кредитов (0,11 $) за 1000 символов. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Qwen3 TTS в API?
Укажите alibaba/qwen-3-tts/text-to-speech — Озвучка текста в поле model запроса POST /jobs/createTask.
Как управлять подачей?
Выберите один из девяти голосов через voice_id и опишите подачу в instructions — тон, эмоцию или темп, в одном-двух предложениях. Инструкции формируют чтение и не произносятся вслух.
Какие языки она читает?
Китайский, английский, немецкий, французский, испанский, итальянский, португальский, русский, японский и корейский — два голоса говорят на пекинском и сычуаньском диалектах. Язык определяется по сценарию, если вы не зададите language.
Может ли она скопировать голос реального человека?
Нет. На этом эндпоинте доступны только девять готовых голосов; клонирования и загрузки эталонного голоса нет.
Какие ограничения у API Qwen3 TTS?
Длина текста (символов): 2,000; Голоса: 9; Языки: 10. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Qwen3 TTS без кода?
Да. Playground запускает Qwen3 TTS на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.

