ElevenLabs
ElevenLabs Sound Effects
elevenlabs/sound-effects-v3
La série de génération d'effets sonores à partir de texte d'ElevenLabs permet de créer des effets sonores en décrivant l'action, la scène et l'ambiance en langage naturel, avec réglage de la durée, de la boucle sans coupure et du degré de suivi du prompt, idéale pour les effets sonores de jeux, le bruitage de prévisualisation cinématographique et les nappes d'ambiance
Essayer elevenlabs/sound-effects-v3
Entrée
Créations
Voir toutes les créationsSortie
Tarifs
elevenlabs/sound-effects-v3 per second
| Prix unitaire | $0.0029 |
|---|
Présentation et positionnement
Modèle audio qui génère des effets sonores à partir d'une description textuelle, avec la possibilité de préciser par prompt l'action, l'environnement, l'ambiance et le mode d'expression. Les entrées comprennent une description sonore obligatoire et une durée, avec en option la boucle sans couture et le degré d'influence du prompt. Adapté aux équipes de développement de jeux, de post-production cinéma/vidéo, de création de vidéos courtes et de produits interactifs, pour obtenir rapidement des effets sonores courts directement intégrables à un projet.
Points forts
- Prompt de 450 caractères maximum — décrivez en une phrase l'action, la scène et l'ambiance ; la limite de 450 caractères offre assez d'espace pour couvrir des détails sonores assez fins.
- Durée réglable de 0,5 à 30 secondes — indiquez le nombre de secondes requis à chaque requête, couvrant les longueurs courantes, du clic bref au son d'ambiance d'une demi-minute.
- Sortie en boucle sans couture — une fois la boucle sans couture activée, l'effet sonore généré se raccorde début-fin, idéal pour les fonds ou les bruits mécaniques à lecture continue.
- Degré d'influence du prompt ajustable — contrôlez la fidélité avec une valeur de 0 à 1 : plus la valeur est basse, plus le résultat est varié ; plus elle est haute, plus il colle à la description.
Description des capacités
Génération d'effets sonores à partir d'une description textuelle : soumettez une description sonore de l'action, de la scène, de l'ambiance et du mode d'expression, et le modèle produit l'audio correspondant ; la description est obligatoire et ne peut pas contenir uniquement des espaces, avec un maximum de 450 caractères.
Durée d'effet sonore personnalisée : chaque requête doit spécifier une durée de 0,5 à 30 secondes ; la durée automatique n'est pas prise en charge, les effets courts comme les sons d'ambiance plus longs sont produits avec le même jeu de paramètres.
Option de boucle sans couture : en activant la boucle sans couture, l'effet sonore généré convient à une lecture continue ; désactivée, la sortie est un effet sonore ponctuel classique.
Réglage de la fidélité au prompt : le paramètre d'influence du prompt, de 0 à 1, équilibre variabilité et fidélité du résultat ; 0 laisse plus de liberté, 1 suit plus strictement la description, la valeur par défaut étant 0,3.
Cas d'usage
- Effets sonores de retour d'interaction pour les équipes de jeu — saisissez des descriptions d'actions comme un clic de bouton ou le déclenchement d'une compétence avec une durée courte pour obtenir des éléments audio directement utilisables sur les événements du jeu.
- Complément de sons d'ambiance en post-production — générez avec une description de scène et d'ambiance une dizaine de secondes de son d'ambiance, à placer sur la timeline de montage comme fond ou effet de transition.
- Habillage sonore pour les créateurs de vidéos courtes — décrivez selon le contenu de l'image des effets courts comme des transitions ou des notifications, en une à deux secondes, pour les pistes d'effets du logiciel de montage.
- Sons d'arrière-plan en boucle pour les produits interactifs — activez la boucle sans couture et fixez la durée pour générer un son mécanique ou d'ambiance lisible en continu, utilisé comme retour sonore dans les démos et les prototypes.
Limites et conseils de choix
Le prompt est limité à 450 caractères ; au-delà, il faut le condenser. Chaque requête doit spécifier une durée de 0,5 à 30 secondes ; la durée automatique n'est pas prise en charge. Si la description est trop courte ou si le paramètre d'influence privilégie la variation, le résultat peut différer des attentes et nécessiter plusieurs essais. La sortie est un effet sonore, le modèle ne convient pas aux tâches exigeant une composition musicale complète ou un chant vocal.
Questions fréquentes
Voir toutes les questions →-
Quelle est la durée maximale d'un effet sonore que ce modèle peut générer ?
La durée maximale prise en charge diffère entre la version actuelle et la précédente. elevenlabs/sound-effects-v3 permet de définir 0,5 à 30 secondes par génération, tandis que elevenlabs/sound-effects-v2 va de 0,5 à 22 secondes ; dans les deux cas, duration_seconds doit être transmis explicitement, la durée automatique n'étant pas prise en charge.
-
Comment faire en sorte que le résultat généré corresponde davantage à ma description ?
Il suffit d'augmenter prompt_influence, qui contrôle le degré de suivi du prompt. Cette valeur va de 0 à 1, avec une valeur par défaut de 0.3 ; plus elle est proche de 1, plus la génération respecte strictement la description littérale, plus elle est proche de 0, plus elle est permissive et produit davantage de variations, ce qui convient aux scénarios nécessitant une créativité inattendue.
-
Comment rédiger un prompt de bruitage efficace ?
Il est recommandé d'organiser la description selon quatre éléments : « action, environnement, ambiance, interprétation », et de la rédiger en un paragraphe cohérent. Par exemple, indiquez d'abord quelle action produit le son, puis le contexte dans lequel il se produit et si l'ambiance générale est tendue ou calme, et enfin ajoutez des détails d'interprétation comme le timbre ou le rythme ; limitez l'ensemble du paragraphe à 450 caractères. La v3 suit plus fidèlement ce type de prompt contenant plusieurs instructions : structurer clairement les éléments est plus efficace que d'empiler des synonymes.
-
Comment générer un effet sonore en boucle ?
Définissez loop sur true pour générer un effet sonore en boucle sans couture. Le résultat ne contient aucun point de départ ni de fin perceptible, ce qui le rend adapté aux ambiances, aux textures environnementales et aux fonds sonores de longue durée ; la valeur par défaut est false, c'est-à-dire un effet sonore ordinaire avec un début et une fin.
Créer une tâche de génération
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.
Idempotency-KeystringOptionnelClé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.
En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.
Corps
modelstringRequisValeur fixe actuelle : elevenlabs/sound-effects-v3
routestringOptionnelValeur fixe actuelle : default
inputobjectRequis
Objet de paramètres métier pour elevenlabs/sound-effects-v3 et la route default — voir le tableau des paramètres ci-dessous.
loopbooleanOptionnelDéfaut: falseContrôle si un effet sonore bouclable en continu est généré ; valeur booléenne, par défaut false (pas de boucle).
promptstringRequisminLength 1maxLength 450pattern \STexte décrivant l'effet sonore souhaité ; doit couvrir l'action, la scène, l'ambiance et le mode d'expression, 450 caractères maximum.
duration_secondsnumberRequisDéfaut: 2min 0.5max 30Durée de l'effet sonore généré, en secondes ; plage de valeurs de 0,5 à 30, par défaut 2 ; la durée automatique n'est pas prise en charge.
prompt_influencenumberOptionnelDéfaut: 0.3min 0max 1Contrôle le degré de respect du prompt par le résultat généré ; une valeur de 0 donne un résultat plus aléatoire et varié, une valeur de 1 suit plus strictement la description, par défaut 0,3.
callbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.
urlstringRequisObligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.
whenstringOptionnelDéfaut: "final"Seul final est pris en charge pour l'instant — notifié sur success et fail.
finalstoragestringOptionnelDéfaut: "temp"Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.
temppersistentExemples de requête
# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "elevenlabs/sound-effects-v3",
input: {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": False,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Obtenir le détail de la tâche
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
queued En file, pas encore démarrée.
handling En cours de traitement.
archiving Traitement terminé, préparation des artefacts.
success Terminal : terminé, artefacts disponibles (output renvoyé).
fail Terminal : échec (error renvoyé).
Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes Unix de l'état terminal ; 0 tant que non terminal.
outputarrayOptionnel
Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).
Array [ object ]
Éléments du tableau
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription de l'erreur.
Exemples de réponse
Succès
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} En cours (non terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Échec
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
Voir tous les articles →-
Guide d'utilisation
Prompts pour ElevenLabs Sound Effects v3 : organiser la description d'un effet sonore autour du matériau, de l'action et de la distance
-
Guide d'utilisation
ElevenLabs Sound Effects v3 effets sonores en boucle en pratique : du bruit de fond stable à la validation des raccords
-
Guide d'utilisation
API ElevenLabs Sound Effects v3 : effets sonores de 30 secondes, boucles sans couture et migration depuis la v2
Prix, paramètres, exemples de requêtes et rédaction des prompts, tout en un article
Modèles associés
Voir tous les modèles →Même type
-
MiniMax Music 3 MiniMax $0.0026 /seconde -
MiniMax Music 1.5 MiniMax $0.070 /morceau -
Lyria 3.5 Google $0.090 /morceau -
Qwen Audio 3.0 TTS Alibaba $0.030 /1 000 caractères -
Lyria 3 Pro Google $0.140 /morceau -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 2.6 MiniMax $0.210 /morceau -
Mirelo SFX 2.0 Mirelo AI $0.021 /seconde -
ElevenLabs ElevenLabs $0.125 /1 000 caractères


