Introduction
Envoyez le texte à lire et, en option, l'une des neuf voix, une brève note sur l'interprétation et une langue. La tâche renvoie un fichier MP3 (mono, 24 kHz) avec le script lu dans cette voix. instructions reçoit une direction en langage simple telle que le ton, l'émotion ou le rythme, et n'est pas prononcé à voix haute. SpicyAPI n'applique aucun filtre de contenu : les scripts NSFW sont lus tels quels. Vous êtes facturé par 1 000 caractères du texte envoyé, avec un minimum de 100 caractères.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Audio |
| Champ obligatoire | text — de 1 à 2 000 caractères |
| Champs optionnels |
|
| Résultat | Un fichier MP3, 24 kHz, mono |
| Quantité facturée | Caractères de text envoyés, comptés par milliers ; minimum 100 |
| Durée typique | Environ 30 secondes pour 300 caractères |
| Conservation | L'audio généré est conservé 14 jours |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
text | Oui | Les mots à prononcer, exactement comme écrits. Facturé par 1 000 caractères, minimum 100 par requête. 1 caractères minimum · 2000 caractères maximum |
voice_id | Non | L'une des neuf voix prédéfinies. Serena par défaut. |
instructions | Non | Direction en langage simple sur le ton, l'émotion ou le rythme. Façonne l'interprétation et n'est pas prononcé. 1000 caractères maximum |
language | Non | Langue de la lecture. auto la détecte à partir du script. |
Tarification
$0.068 / 1 000 caractères
Facturé par 1 000 caractères du texte envoyé, espaces et ponctuation comprises, avec un minimum de 100 caractères par requête. Le devis affiché avant l'exécution est le prix final.
Cas d’utilisation
Voix de personnages et de compagnons
Neuf voix distinctes — du timbre clair et mordant au grave et feutré — chacune avec une brève note sur sa façon de parler, conservée pour toute une série.
Répliques en chinois, japonais et coréen
Dylan et Eric parlent les dialectes de Pékin et du Sichuan, et Ono_Anna et Sohee sont des voix natives japonaise et coréenne, si bien que les répliques dans ces langues sonnent naturelles plutôt qu'accentuées.
Histoires audio sans censure
Les scripts NSFW sont lus tels quels. Dans nos tests, le modèle a prononcé chaque mot des monologues et des narrations que nous avons envoyés, sans rien omettre ni couper le clip trop tôt.
Pistes vocales pour vidéo
Générez la réplique ici, puis confiez le MP3 à un modèle de talking-avatar ou de lip-sync pour qu'un visage l'interprète.
Guide de prompt et conseils pratiques
Envoyer le script dans text
Rédigez-le exactement comme il doit être prononcé, avec la ponctuation pour les pauses. Jusqu'à 2 000 caractères ; en dessous de 100, la facturation est de 100.
Choisir une voix
voice_idutilise Serena par défaut, une voix féminine chaleureuse et douce. Ryan et Aiden sont des voix masculines anglaises ; Ono_Anna et Sohee sont japonaise et coréenne ; Dylan et Eric parlent les dialectes de Pékin et du Sichuan.Décrire l'interprétation
Rédigez une ou deux phrases dans instructions — par exemple « essoufflée et taquine, tout près du microphone ». Ce texte n'est pas prononcé à voix haute.
Ce qui est renvoyé
Un fichier MP3 par tâche, mono 24 kHz. Le fichier est copié dans le stockage SpicyAPI et conservé 14 jours. Le résultat ne contient ni minutage par mot ni sous-titres.
Choisir une voix
voice_id accepte l'une des neuf voix prédéfinies et utilise Serena par défaut :
Serena— jeune voix féminine chaleureuse et douceVivian— jeune voix féminine claire, légèrement mordanteUncle_Fu— voix masculine expérimentée, au timbre grave et feutréRyan— voix masculine dynamique, au rythme marquéAiden— voix masculine américaine enjouéeOno_Anna— voix féminine japonaise malicieuseSohee— voix féminine coréenne chaleureuse et émouvanteDylan— voix masculine jeune parlant le dialecte de PékinEric— voix masculine pleine d'entrain parlant le dialecte du Sichuan (Chengdu)
Diriger l'interprétation
instructions reçoit une ou deux phrases en langage simple sur la façon de lire : ton, émotion, rythme. Cela façonne la performance et n'est pas prononcé. Les curseurs de vitesse et de hauteur ne sont pas exposés ; demandez-les dans instructions.
Langue
language utilise auto par défaut, qui détecte la langue à partir du script. Définissez zh, en, de, fr, es, it, pt, ru, ja ou ko lorsqu'un script court ou multilingue est lu dans la mauvaise langue.
Facturation
Facturé par 1 000 caractères de text, espaces, ponctuation et sauts de ligne compris, avec un minimum de 100 caractères par requête ; instructions est gratuit. Le nombre de caractères est connu avant le début de la tâche, si bien que le devis est le montant final. Les requêtes en échec ne sont pas facturées.
Contenu
SpicyAPI n'ajoute aucun filtre de contenu. Dans nos tests, les scripts non filtrés ont été lus mot pour mot, sans rien omettre et sans qu'aucun clip ne s'arrête prématurément.
SpicyAPI n'ajoute aucun filtre de contenu : les scripts NSFW sont lus tels quels. Vous êtes responsable des scripts que vous envoyez et de l'usage que vous faites de l'audio obtenu, y compris de ne pas le faire passer pour les propos d'une personne réelle.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-3-tts/text-to-speech",
"input": {
"text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
"language": "auto",
"voice_id": "Serena"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.





