Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
pace | No | Rhythm of the reading. Omit it to keep the voice's own rhythm. natural · rapid_fire · the_drift · staccato |
text | No | The words to be spoken, exactly as written. Spell out sounds such as sighs or laughter; bracketed cues may be read aloud. |
scene | No | Where and to whom the words are spoken. Shapes the delivery and is not spoken. |
style | No | Un estilo o género predefinido. whisper · empathetic · vocal_smile · newscaster · promo_hype · deadpan |
accent | No | English accent used for the reading. neutral · american_general · american_valley · american_south · british_rp · british_brixton · transatlantic · australian |
dialogue | No | A scripted conversation, used instead of text: each line names a speaker from speakers. |
speakers | No | The cast for dialogue: one or two voices, each with a name the lines refer to. |
voice_id | No | Elige entre las voces disponibles. 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 · Por defecto: Kore |
temperature | No | Variation between takes; higher is less predictable. ≥ 0 · ≤ 2 |
instructions | No | How to read the text: mood, distance from the microphone, who is listening. Shapes the delivery and is not spoken. |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por segundo | ≈ USD |
|---|---|---|
| Estándar | 0,03 | 0,0003 US$ |
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Gemini 3.8 Flash-Lite TTS en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model google/gemini-3.8-flash-lite-tts/text-to-speech y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 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-lite-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"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Gemini 3.8 Flash-Lite TTS
¿Cuánto cuesta la API de Gemini 3.8 Flash-Lite TTS?
Gemini 3.8 Flash-Lite TTS cuesta 0,03 créditos (0,0003 US$) por segundo. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Gemini 3.8 Flash-Lite TTS en la API?
Pon google/gemini-3.8-flash-lite-tts/text-to-speech para Texto a voz en el campo model de POST /jobs/createTask.
¿Cómo controlo cómo suena?
Elige una de las 30 voces con voice_id y dirige la lectura con style, accent, pace, instructions y scene; la puntuación da forma a las pausas. La dirección da forma a la lectura y no se lee en voz alta.
¿Interpreta indicaciones entre corchetes como [sighs]?
No de forma confiable. En nuestras pruebas, a veces leía en voz alta las palabras dentro de los corchetes en lugar de interpretarlas. Escribe los sonidos como sonidos —"Mmm…", "ahh…"— o usa Gemini 3.8 Flash TTS, que interpretó las mismas indicaciones en nuestras pruebas.
¿Puede copiar la voz de una persona real?
No. Aquí solo están disponibles las 30 voces prediseñadas; no hay clonación, no hay diseño de voz ni carga de una voz de referencia.
¿Qué límites tiene la API de Gemini 3.8 Flash-Lite TTS?
Longitud del texto (caracteres): 5,000; Voces: 30. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Gemini 3.8 Flash-Lite TTS sin escribir código?
Sí. El Playground ejecuta Gemini 3.8 Flash-Lite TTS con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Gemini
- API de Gemini 3.8 Flash TTSVoz expresiva que interpreta indicaciones como [laughing]Desde 0,05 créditos por segundo
- API de Gemini 3.8 Flash-Lite TTSVoz rápida y ligera con 30 vocesDesde 0,03 créditos por segundo
- API de Gemini 2.5 Pro TTSVoces que se dejan dirigir, para narración y diálogos a dos vocesDesde 0,07 créditos por segundo


