Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
pace | Нет | Rhythm of the reading. Omit it to keep the voice's own rhythm. natural · rapid_fire · the_drift · staccato |
text | Нет | The words to be spoken, exactly as written. Direction such as [whispering] or [sighs] goes into the text itself. |
scene | Нет | Where and to whom the words are spoken. Shapes the delivery and is not spoken. |
style | Нет | Готовый стиль или жанр. whisper · empathetic · vocal_smile · newscaster · promo_hype · deadpan |
accent | Нет | English accent used for the reading. neutral · american_general · american_valley · american_south · british_rp · british_brixton · transatlantic · australian |
dialogue | Нет | A scripted conversation, used instead of text: each line names a speaker from speakers. |
speakers | Нет | The cast for dialogue: one or two voices, each with a name the lines refer to. |
voice_id | Нет | Выберите один из доступных голосов. Achernar · Achird · Algenib · Algieba · Alnilam · Aoede · Autonoe · Callirrhoe · Charon · Despina · Enceladus · Erinome · Fenrir · Gacrux · Iapetus · Kore · Laomedeia · Leda · Orus · Puck · Pulcherrima · Rasalgethi · Sadachbia · Sadaltager · Schedar · Sulafat · Umbriel · Vindemiatrix · Zephyr · Zubenelgenubi · По умолчанию: Kore |
temperature | Нет | Variation between takes; higher is less predictable. ≥ 0 · ≤ 2 |
instructions | Нет | How to read the text: mood, distance from the microphone, who is listening. Shapes the delivery and is not spoken. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за секунду | ≈ USD |
|---|---|---|
| Стандарт | 0,05 | 0,0005 $ |
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Gemini 3.8 Flash TTS в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model google/gemini-3.8-flash-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": "google/gemini-3.8-flash-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "Kore"
}
}'
# 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 Gemini 3.8 Flash TTS
Сколько стоит API Gemini 3.8 Flash TTS?
Gemini 3.8 Flash TTS стоит 0,05 кредита (0,0005 $) за секунду. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Gemini 3.8 Flash TTS в API?
Укажите google/gemini-3.8-flash-tts/text-to-speech — Озвучка текста в поле model запроса POST /jobs/createTask.
Как управлять звучанием?
Выберите один из 30 голосов через voice_id, а затем направляйте чтение через style, accent, pace, instructions и scene или прямо в сценарии: указания в квадратных скобках вроде [whispering], [sighs] или [laughing] отыгрываются, а пунктуация задаёт паузы. Режиссура влияет на чтение и не зачитывается.
Может ли она скопировать голос реального человека?
Нет. Здесь доступны только 30 готовых голосов; клонирования, дизайна голоса и загрузки эталонного голоса нет.
Какие ограничения у API Gemini 3.8 Flash TTS?
Длина текста (символов): 5,000; Голоса: 30. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Gemini 3.8 Flash TTS без кода?
Да. Playground запускает Gemini 3.8 Flash TTS на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Gemini
Gemini 3.8 Flash Lite TTS использует те же голоса, но стоит дешевле и подходит для черновиков и больших партий. Полная модель Flash читает выразительнее.
- Gemini 3.8 Flash TTS APIВыразительная речь, которая отыгрывает пометки вроде [laughing]От 0,05 кредита за секунду
- Gemini 3.8 Flash-Lite TTS APIБыстрая лёгкая озвучка, 30 голосовОт 0,03 кредита за секунду
- Gemini 2.5 Pro TTS APIГолоса, которыми можно режиссировать: дикторский текст и диалоги на двоихОт 0,07 кредита за секунду


