Guides Imọlẹ Parcours85 / 88
Modèle · Audio

ElevenLabs Sound Effects

Effets sonores et audio d’ambiance depuis des prompts texte.

Identifiant du modèleeleven_text_to_sound_v2
Route API POST /audio/sound-generation
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Effets sonores crée un événement audio ou une ambiance à partir d’une description acoustique concrète.

Cette page rassemble la description du modèle, les réglages exposés par Imọlẹ et les informations nécessaires pour l’appeler avec l’API.

Capacités

Résultats et opérations pris en charge

  • Impacts, interfaces, environnements, transitions, bruitages et ambiances bouclables.
Demande

Décrire clairement le résultat attendu

Construisez la demande dans cet ordre. Chaque étape précise une information que le modèle peut utiliser directement.

  1. 01

    Source sonore

    Nommez l’objet, le matériau, la créature ou l’environnement qui produit le son.

  2. 02

    Action

    Décrivez impact, mouvement, rythme, distance et intensité.

  3. 03

    Espace acoustique

    Définissez taille, ouverture, réverbération, perspective et fond sonore.

  4. 04

    Durée et boucle

    Indiquez s’il s’agit d’un son unique, d’une texture évolutive ou d’une boucle continue.

Exemple 1

Son de réussite interface

Notification de réussite en deux parties : clic doux en bois suivi d’un court scintillement de verre chaleureux, intime et premium, aucune mélodie, aucun impact grave, réverbération inférieure à une demi-seconde, durée totale 1,2 seconde.

Le prompt décrit la source, la séquence, le caractère, les exclusions et la durée.

Réglages

Contrôles disponibles dans Imọlẹ

Fidélité au prompt

Augmentez-la lorsque les éléments décrits doivent être exacts ; baissez-la pour plus de variation.

Boucle

Activez-la uniquement pour une ambiance ou texture destinée à se répéter.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/audio/sound-generation
URL de basehttps://api.imole.app/v1
Coût API15 cauris
AuthorizationBearer $IMOLE_API_KEY
Content-TypeUtilisez application/json pour les requêtes JSON.

Chargez IMOLE_API_KEY depuis une variable d’environnement côté serveur. N’insérez jamais la clé dans le code envoyé au navigateur, une application mobile, un dépôt Git ou un fichier partagé.

Corps de requête

Paramètres acceptés

ParamètreDescriptionValeurs
modelRequis

Utilisez eleven_text_to_sound_v2.

—
promptRequis

Description de l’effet sonore.

—
duration_seconds

Durée demandée en secondes.

—
prompt_influence

Niveau de fidélité à la description.

—
loop

Demande un son pouvant être lu en boucle.

true, false
output_format

Format audio demandé.

—
Code

Exemples d’intégration

Testez d’abord la requête cURL, puis reprenez le même identifiant de modèle dans votre application JavaScript ou Python.

Son de notification

curl -X POST "https://api.imole.app/v1/audio/sound-generation" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_text_to_sound_v2",
  "prompt": "A soft confirmation chime for an API success notification",
  "duration_seconds": 1.5,
  "prompt_influence": 0.7
}' \
  --output sound-effect.mp3

Ambiance en boucle

curl -X POST "https://api.imole.app/v1/audio/sound-generation" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_text_to_sound_v2",
  "prompt": "A subtle looping office ambience with keyboard taps and light room tone",
  "duration_seconds": 4,
  "loop": true
}' \
  --output sound-effect-loop.mp3

Clic de bouton

curl -X POST "https://api.imole.app/v1/audio/sound-generation" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_text_to_sound_v2",
  "prompt": "A short tactile mobile button click",
  "duration_seconds": 1,
  "prompt_influence": 0.5
}' \
  --output sound-effect-click.mp3
Production

Réponse, suivi et erreurs

La route renvoie un fichier ou un objet JSON selon l’opération. Contrôlez le statut HTTP et le type de contenu avant de stocker la réponse.

400

Requête incorrecte : corrigez le champ indiqué avant de réessayer.

401

Clé absente, incorrecte ou révoquée.

402

Solde de cauris insuffisant.

429

Capacité temporairement indisponible : respectez `Retry-After` et utilisez un délai progressif.

5xx

Erreur temporaire : conservez l’identifiant de requête et évitez de relancer deux fois une opération facturable.

Cauris

Tarification et sources

Coût affiché15 cauris

Le coût exact dépend du modèle et, pour certains médias, de la durée, de la résolution ou de la qualité.

Documentation de référenceDocumentation des effets sonores d’ElevenLabs