Introduction
Décrivez toute la scène sonore dans un seul prompt : qui parle, comment, et les répliques entre guillemets, ainsi que la musique, l'ambiance ou les effets sonores. La tâche renvoie un fichier audio d'environ deux minutes au maximum qui contient tout ce que vous avez décrit, y compris les dialogues de plusieurs intervenants : un MP3, sauf si vous définissez output_format. Pour réutiliser une voix, importez jusqu'à trois clips de référence dans reference_audio_urls et nommez-les @Audio1 à @Audio3 dans le prompt, ou donnez une image de référence dans image_url à la place ; speed, pitch et volume affinent l'interprétation. SpicyAPI n'applique aucun filtre de contenu : chaque prompt est lu tel qu'écrit. Chaque requête coûte le même prix forfaitaire.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Audio |
| Champ obligatoire | prompt — de 1 à 2 000 caractères |
| Champs optionnels |
|
| Résultat | Un fichier audio d’environ deux minutes maximum : MP3 par défaut, ou WAV, Ogg Opus, PCM |
| Locuteurs | Plusieurs, décrits dans le prompt ou repris d’au plus trois extraits de référence ; pas de liste de voix |
| Quantité facturée | Un prix forfaitaire par requête |
| Conservation | L'audio généré est conservé 14 jours |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez toute la scène en 2 000 caractères maximum : chaque locuteur et sa manière de sonner, ses répliques exactes entre guillemets, ainsi que toute musique, ambiance ou effet… 1 caractères minimum · 2000 caractères maximum |
reference_audio_urls | Non | Jusqu’à trois extraits MP3 ou WAV de référence : importez-les ou indiquez des URL publiques. Chaque extrait peut durer jusqu’à 30 secondes et peser jusqu’à 10 Mo. 3 éléments maximum |
image_url | Non | Image de référence facultative autour de laquelle le son est construit : importez-la ou indiquez une URL publique, puis décrivez dans prompt ce que dit la personne représentée o… 1 caractères minimum |
speed | Non | Débit de parole de 0,5 (plus lent) à 2 (plus rapide) ; 1 correspond au rythme normal de la voix. Ne modifie pas le prix. |
pitch | Non | Décalage de hauteur en demi-tons, de -12 à 12 ; 0 conserve la hauteur propre de la voix. Ne modifie pas le prix. |
volume | Non | Multiplicateur de volume de 0,5 à 2 ; 1 correspond au niveau normal. Ne modifie pas le prix. |
output_format | Non | Format de fichier : mp3 (par défaut), wav, opus (Ogg Opus) ou pcm, c’est-à-dire des échantillons stéréo bruts 16 bits little-endian, entrelacés et sans en-tête, au |
sample_rate | Non | Fréquence d’échantillonnage de l’audio en Hz : 8000, 16000, 24000, 32000, 44100, 48000. Par défaut : 24000. |
Tarification
$0.36 / requête
Un prix forfaitaire par requête, un clip d'environ deux minutes maximum.
Cas d’utilisation
Fictions audio à plusieurs personnages
Décrivez deux locuteurs ou plus et mettez leurs répliques entre guillemets, et le modèle donne à chacun une voix distincte dans le même clip — sans avoir besoin d'un modèle de voix séparé pour chaque personnage.
Scènes avec conception sonore
Un seul prompt peut demander à la fois dialogue, musique de fond, ambiance et effets sonores, de sorte qu'une seule requête renvoie une scène terminée plutôt qu'une simple ligne vocale.
Fiction audio non censurée
Les prompts sont lus tels qu'écrits, sans filtre de contenu. Dans nos tests, un monologue à la première personne, une fiction racontée et une scène sur fond de pluie, tous rédigés au-delà de ce que d'autres services acceptent, sont revenus avec chaque mot prononcé.
Pistes vocales pour la vidéo
Générez la scène ici, puis transmettez le MP3 à un modèle d'avatar parlant ou de synchronisation labiale pour qu'un visage l'interprète.
Guide de prompt et conseils pratiques
Décrire les locuteurs
Précisez qui parle et comment — un chuchotement essoufflé, un narrateur chaleureux — et mettez leurs mots exacts entre guillemets.
Ajouter le paysage sonore
Mentionnez toute musique, ambiance ou effet sonore que vous voulez entendre avec le dialogue : une tempête de pluie, une horloge qui tictaque, une musique qui monte en intensité.
Rester sous 2 000 caractères
Un prompt couvre une scène d'environ deux minutes maximum ; les histoires plus longues doivent être réparties sur plusieurs requêtes.
Ce qui est renvoyé
Un fichier audio par tâche, d’environ deux minutes maximum, en MP3 sauf si vous modifiez output_format. Le fichier est copié dans le stockage SpicyAPI et conservé 14 jours.
Rédiger le prompt
Seed Audio 1.0 accepte un seul champ prompt (2 000 caractères maximum) qui décrit toute la scène :
- Qui parle et comment — un chuchotement, un narrateur chaleureux, une réplique criée.
- Leurs mots exacts, entre guillemets.
- Toute musique, ambiance ou effet sonore souhaité avec le dialogue.
Ce modèle prend en charge plusieurs locuteurs dans le même clip : décrivez chaque personnage et ses répliques, et il donne à chacun une voix distincte.
Audio et image de référence
Il n’y a pas de liste de voix. Pour réutiliser une voix ou un son, importez jusqu’à trois extraits dans reference_audio_urls et nommez-les dans le prompt @Audio1, @Audio2 et @Audio3, dans l’ordre d’envoi, par exemple « Avec la voix de @Audio1, un homme dit… ». Ou fournissez une image dans image_url et décrivez ce que dit la personne représentée ou l’ambiance sonore de la scène ; les deux entrées ne se combinent pas. N’utilisez que des voix et des images que vous avez le droit d’utiliser.
Interprétation et format
speed (0,5 à 2), pitch (-12 à 12 demi-tons) et volume (0,5 à 2) affinent l’interprétation. output_format choisit mp3 (par défaut), wav, opus (Ogg Opus) ou pcm, et sample_rate va de 8000 à 48000 Hz. pcm correspond à des échantillons stéréo bruts 16 bits little-endian sans en-tête, qu’on ne peut donc pas écouter dans un navigateur. Choisissez wav pour obtenir les mêmes échantillons dans un fichier lisible. Aucun de ces réglages ne modifie le prix.
Facturation
Un prix forfaitaire par requête, quelle que soit la longueur du prompt. Les requêtes en échec ne sont pas facturées.
Contenu
SpicyAPI n'ajoute aucun filtre de contenu. Dans nos tests, trois prompts que d'autres services refusent — un monologue à la première personne, une fiction racontée et une scène sur fond de pluie — sont tous revenus avec chaque mot prononcé.
SpicyAPI n'ajoute aucun filtre de contenu : les prompts sont lus tels qu'écrits, quel que soit leur contenu. Vous êtes responsable des scènes que vous décrivez et de l'usage que vous faites de l'audio obtenu, y compris le fait de ne pas le présenter comme 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": "bytedance/seed-audio-1.0/text-to-audio",
"input": {
"output_format": "mp3",
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 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.
