Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
pace | Non | Rhythm of the reading. Omit it to keep the voice's own rhythm. natural · rapid_fire · the_drift · staccato |
text | Non | The words to be spoken, exactly as written. Direction such as [whispering] or [sighs] goes into the text itself. |
scene | Non | Where and to whom the words are spoken. Shapes the delivery and is not spoken. |
style | Non | Un look ou un genre prédéfini. whisper · empathetic · vocal_smile · newscaster · promo_hype · deadpan |
accent | Non | English accent used for the reading. neutral · american_general · american_valley · american_south · british_rp · british_brixton · transatlantic · australian |
dialogue | Non | A scripted conversation, used instead of text: each line names a speaker from speakers. |
speakers | Non | The cast for dialogue: one or two voices, each with a name the lines refer to. |
voice_id | Non | Choisissez parmi les voix 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 · Par défaut: Kore |
temperature | Non | Variation between takes; higher is less predictable. ≥ 0 · ≤ 2 |
instructions | Non | How to read the text: mood, distance from the microphone, who is listening. Shapes the delivery and is not spoken. |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par seconde | ≈ USD |
|---|---|---|
| Standard | 0,05 | 0,0005 $US |
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API Gemini 3.8 Flash TTS en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model google/gemini-3.8-flash-tts/text-to-speech et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 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"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Gemini 3.8 Flash TTS
Combien coûte l’API Gemini 3.8 Flash TTS ?
Gemini 3.8 Flash TTS coûte 0,05 crédit (0,0005 $US) par seconde. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de Gemini 3.8 Flash TTS dans l’API ?
Indiquez google/gemini-3.8-flash-tts/text-to-speech pour Synthèse vocale dans le champ model de POST /jobs/createTask.
Comment contrôler le rendu sonore ?
Choisissez l’une des 30 voix avec voice_id, puis dirigez la lecture avec style, accent, pace, instructions et scene, ou dans le script : les indications entre crochets comme [whispering], [sighs] ou [laughing] sont jouées, et la ponctuation règle les pauses. La direction façonne la lecture et n’est pas lue.
Peut-il copier la voix d’une personne réelle ?
Non. Seules les 30 voix prédéfinies sont disponibles ici ; il n’y a ni clonage, ni conception de voix, ni import d’une voix de référence.
Quelles sont les limites de l’API Gemini 3.8 Flash TTS ?
Longueur du texte (caractères): 5,000; Voix: 30. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Gemini 3.8 Flash TTS sans écrire de code ?
Oui. Le Playground lance Gemini 3.8 Flash TTS avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles Gemini
Gemini 3.8 Flash Lite TTS utilise les mêmes voix pour moins cher, et convient aux brouillons et aux longs lots. Le modèle Flash complet donne la lecture la plus expressive.
- API Gemini 3.8 Flash TTSUne voix expressive qui joue les indications comme [laughing]À partir de 0,05 crédit par seconde
- API Gemini 3.8 Flash-Lite TTSSynthèse vocale rapide et légère, 30 voixÀ partir de 0,03 crédit par seconde
- API Gemini 2.5 Pro TTSDes voix à diriger pour la narration et les dialogues à deuxÀ partir de 0,07 crédit par seconde


