Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
pace | Não | Rhythm of the reading. Omit it to keep the voice's own rhythm. natural · rapid_fire · the_drift · staccato |
text | Não | The words to be spoken, exactly as written. Direction such as [whispering] or [sighs] goes into the text itself. |
scene | Não | Where and to whom the words are spoken. Shapes the delivery and is not spoken. |
style | Não | Um visual ou gênero predefinido. whisper · empathetic · vocal_smile · newscaster · promo_hype · deadpan |
accent | Não | English accent used for the reading. neutral · american_general · american_valley · american_south · british_rp · british_brixton · transatlantic · australian |
dialogue | Não | A scripted conversation, used instead of text: each line names a speaker from speakers. |
speakers | Não | The cast for dialogue: one or two voices, each with a name the lines refer to. |
voice_id | Não | Escolha entre as vozes disponíveis. 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 · Padrão: Kore |
temperature | Não | Variation between takes; higher is less predictable. ≥ 0 · ≤ 2 |
instructions | Não | How to read the text: mood, distance from the microphone, who is listening. Shapes the delivery and is not spoken. |
Preços
Os preços são em créditos, os mesmos que você usa no site (1 crédito = US$ 0,01). O valor é reservado quando a tarefa é aceita e acertado pelo custo real quando ela termina; tarefas com falha são reembolsadas.
| Opção | Créditos por segundo | ≈ USD |
|---|---|---|
| Padrão | 0,05 | US$ 0,0005 |
Para saber o valor exato antes de rodar, envie o mesmo corpo para POST /jobs/quote.
Início rápido da API
Chame a API do Gemini 3.8 Flash TTS em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow- e usam os mesmos créditos do site.
- Envie a requisição. Faça POST /jobs/createTask com model google/gemini-3.8-flash-tts/text-to-speech e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 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"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Gemini 3.8 Flash TTS
Quanto custa a API do Gemini 3.8 Flash TTS?
O Gemini 3.8 Flash TTS custa 0,05 crédito (US$ 0,0005) por segundo. Os créditos são os mesmos do site (1 crédito = US$ 0,01), contas novas ganham 30 créditos grátis e tarefas que falham são reembolsadas.
Qual é o nome de modelo do Gemini 3.8 Flash TTS na API?
Coloque google/gemini-3.8-flash-tts/text-to-speech para Texto para fala no campo model de POST /jobs/createTask.
Como eu controlo o jeito que ele soa?
Escolha uma das 30 vozes com voice_id e dirija a leitura com style, accent, pace, instructions e scene, ou dentro do roteiro: marcações entre colchetes como [whispering], [sighs] ou [laughing] são interpretadas, e a pontuação define as pausas. A direção molda a leitura e não é lida em voz alta.
Ele consegue copiar a voz de uma pessoa real?
Não. Aqui só estão disponíveis as 30 vozes prontas; não há clonagem, não há design de voz e não há upload de uma voz de referência.
Quais são os limites da API do Gemini 3.8 Flash TTS?
Tamanho do texto (caracteres): 5,000; Vozes: 30. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Gemini 3.8 Flash TTS sem escrever código?
Dá. O Playground roda o Gemini 3.8 Flash TTS com seus créditos da PopNow, não precisa de chave de API e mostra o código de cada geração.
Todos os modelos Gemini
O Gemini 3.8 Flash Lite TTS usa as mesmas vozes por menos e serve para rascunhos e lotes longos. O modelo Flash completo entrega a leitura mais expressiva.
- API do Gemini 3.8 Flash TTSFala expressiva que interpreta indicações como [laughing]A partir de 0,05 crédito por segundo
- API do Gemini 3.8 Flash-Lite TTSFala rápida e leve em 30 vozesA partir de 0,03 crédito por segundo
- API do Gemini 2.5 Pro TTSVozes que você dirige, para narração e diálogos a doisA partir de 0,07 crédito por segundo


