Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
text | Oui | The words to be spoken, exactly as written. Billed per 1,000 characters. |
pitch | Non | Pitch shift in semitones; 0 keeps the voice's own pitch. ≥ -12 · ≤ 12 · Par défaut: 0 |
speed | Non | Le débit de parole. ≥ 0.5 · ≤ 2 · Par défaut: 1 |
volume | Non | Loudness multiplier; 1 is the normal level. ≥ 0.5 · ≤ 2 · Par défaut: 1 |
language | Non | La langue de la voix. zh · en · ja · es-mx · id · pt-br · ko · it · de · fr |
voice_id | Non | Choisissez parmi les voix disponibles. vivi_mixed_en_zh_ja_es_id · mindy_en_es_id_pt_zh · stokie_en · dacey_en · tim_en · kian_en_zh · cedric_en_zh · sophie_en_zh · jean_en_zh · magnus_en_zh · mabel_en_zh · nadia_en_zh · opal_en_zh · pearl_en_zh · quentin_en_zh · vienna_mixed_en_zh · alina_mixed_en_zh · corinne_mixed_en_zh · esther_mixed_en_zh · freya_mixed_en_zh · gigi_mixed_en_zh · holly_mixed_en_zh · lyla_mixed_en_zh · daisy_mixed_en_zh · tracy_es_zh · jess_ja_es_id_pt_en_zh · pinky_es_ko_mixed_en_zh · sweety_ja_es · sandy_es_mixed_en_zh · sven_de · minimi_ja · usseau_fr · felipe_es · han_id · martins_pt · enzo_it · shane_ko · bonnie_zh · felix_zh · celeste_zh · monkey_king_zh · Par défaut: stokie_en |
sample_rate | Non | Sample rate in Hz. The model uses 24000 when omitted. 8000–48000 |
instructions | Non | How to read the text: tone, emotion, pace or volume. Not spoken and not billed. |
output_format | Non | Le type de fichier du résultat. mp3 · opus · Par défaut: mp3 |
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 pour 1 000 caractères | ≈ USD |
|---|---|---|
| Standard | 10,8 | 0,11 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 11 crédits pour 1 000 caractères (0,11 $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 Seed Speech 2.0 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 bytedance/seed-speech-2.0/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": "bytedance/seed-speech-2.0/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"voice_id": "stokie_en",
"output_format": "mp3"
}
}'
# 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 Seed Speech 2.0
Combien coûte l’API Seed Speech 2.0 ?
Seed Speech 2.0 coûte 11 crédits (0,11 $US) pour 1 000 caractères. 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 Seed Speech 2.0 dans l’API ?
Indiquez bytedance/seed-speech-2.0/text-to-speech pour Synthèse vocale dans le champ model de POST /jobs/createTask.
Comment contrôler l’interprétation ?
Choisissez l’une des 41 voix prédéfinies avec voice_id et décrivez l’interprétation dans instructions — ton, émotion, rythme ou volume, en une ou deux phrases. Les instructions façonnent la lecture et ne sont pas prononcées à voix haute.
Quelles langues peut-il lire ?
Il détecte automatiquement la langue du script. Vous pouvez aussi forcer le chinois, l’anglais, le japonais, l’espagnol du Mexique, l’indonésien, le portugais du Brésil, le coréen, l’italien, l’allemand ou le français avec language. Plusieurs voix sont conçues pour plus d’une langue.
Peut-il copier la voix d’une personne réelle ?
Non. Seules les 41 voix prédéfinies sont proposées sur cet endpoint ; il n’y a ni clonage, ni import d’une voix de référence.
Quelles sont les limites de l’API Seed Speech 2.0 ?
Longueur du texte (caractères): 5,000; Voix: 41; Langues: 10. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Seed Speech 2.0 sans écrire de code ?
Oui. Le Playground lance Seed Speech 2.0 avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

