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

ElevenLabs Voice Design

Créer une nouvelle voix à partir d’une description pour des usages vocaux personnalisés.

Identifiant du modèleeleven_ttv_v3
Route API POST /audio/voice-design
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Voice Design crée une nouvelle voix synthétique à partir d’une description écrite du personnage et de son interprétation.

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

  • Narrateurs originaux, personnages, voix produit et prototypes lorsqu’aucune voix existante ne convient.
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

    Identité

    Tranche d’âge, poids vocal, présentation de genre si utile et rôle du personnage.

  2. 02

    Accent et langue

    Nommez précisément la langue et l’accent sans vous appuyer sur des stéréotypes.

  3. 03

    Texture

    Décrivez brillance, souffle, grain, résonance, chaleur et clarté.

  4. 04

    Interprétation

    Définissez rythme, assurance, énergie, émotion et usage prévu.

Exemple 1

Narratrice documentaire

Femme ouest-africaine francophone d’environ 40 ans, registre médium-grave chaleureux, consonnes claires, autorité calme, sourire subtil, rythme documentaire mesuré, souffle naturel, prise studio intime, adaptée aux récits de technologie et culture, jamais théâtrale.

La description couvre identité, texture, interprétation, sensation d’enregistrement et usage.

Réglages

Contrôles disponibles dans Imọlẹ

Ce modèle utilise principalement son entrée et les paramètres de sa requête. Les valeurs proposées dans le Laboratoire constituent un point de départ stable.

API

Intégrer le modèle dans un projet

MéthodePOST
Chemin/audio/voice-design
URL de basehttps://api.imole.app/v1
Coût API5 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_ttv_v3.

—
promptRequis

Décrivez la voix avec au moins 20 caractères : accent, âge, ton, rythme et usage.

—
output_format

Format des échantillons téléchargés.

—
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.

Texte d’aperçu personnalisé

curl -X POST "https://api.imole.app/v1/audio/voice-design" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_ttv_v3",
  "prompt": "A warm bilingual product guide voice, calm and confident",
  "preview_text": "Welcome to Imole. This preview text is intentionally long enough to produce a valid sample for a short product demonstration.",
  "auto_generate_text": false
}'

Texte d’aperçu automatique

curl -X POST "https://api.imole.app/v1/audio/voice-design" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_ttv_v3",
  "prompt": "A bright young narrator for a software onboarding walkthrough",
  "auto_generate_text": true
}'

Qualité d’aperçu améliorée

curl -X POST "https://api.imole.app/v1/audio/voice-design" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "eleven_ttv_v3",
  "prompt": "A calm technical narrator for API tutorials",
  "preview_text": "Imole keeps documentation simple, direct, and practical for developers, with technical examples that are long enough to produce a valid ElevenLabs voice preview sample.",
  "auto_generate_text": false
}'
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é5 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érenceGuide Voice Design d’ElevenLabs