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

Imole Quick Voice

Synthèse vocale multilingue rapide pour l’API Imọlẹ et l’Agent, avec un catalogue consultable de langues et de voix ainsi que des réglages unifiés de vitesse, de hauteur et de volume.

Identifiant du modèleimole-quick-voice
Route API POST /audio/speech
Tester dans le Laboratoire
Présentation du modèle

Ce que fait ce modèle

Imole Quick Voice privilégie une voix multilingue rapide pour aperçus, assistants et grands volumes.

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

  • Assistants interactifs, aperçus rapides, notifications et grands volumes.
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

    Texte

    Écrivez pour l’oreille : phrases courtes, ponctuation naturelle et prononciation explicite si nécessaire.

  2. 02

    Interprète

    Choisissez une voix ou une référence adaptée au public, à l’âge, à l’accent et à l’usage.

  3. 03

    Interprétation

    Décrivez concrètement le ton, le rythme, l’énergie, l’émotion, les pauses et l’accentuation.

  4. 04

    Sortie

    Choisissez un format adapté au montage, au streaming, à la téléphonie ou à la livraison finale.

Exemple 1

Narration de marque

Texte : « Votre idée mérite plus qu’une démo. Créez-la, testez-la et partagez-la. » Interprétation : chaleureuse et assurée, conversationnelle plutôt que théâtrale, rythme moyen, courte pause après « démo », légère emphase sur « créez-la », prononciation française claire, sourire non exagéré.

La direction utilise des choix audibles et concrets plutôt que de simples adjectifs vagues.

Réglages

Contrôles disponibles dans Imọlẹ

Voix

Choisissez une voix dont le registre naturel correspond déjà au rôle demandé.

Vitesse

Commencez à 1,0. Modifiez la vitesse seulement après avoir rendu ponctuation et longueur des phrases naturelles.

Format de sortie

Utilisez WAV/PCM pour le montage ou une lecture à faible latence et un format compressé pour la livraison et le stockage.

API

Intégrer le modèle dans un projet

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

textRequis

Texte à synthétiser.

language

Langue ou locale retournée par GET /audio/voice-options.

voice

Identifiant de voix facultatif retourné par GET /audio/voice-options. Omettez-le pour sélectionner automatiquement la voix.

speed

Multiplicateur de vitesse vocale.

0.5 to 2
pitch

Réglage de la hauteur de la voix en hertz.

-50 to 50
volume

Multiplicateur de volume.

0 to 2
with_subtitles

Génère un minutage mot par mot lorsque la voix sélectionnée le permet.

true, false
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.

Lister les langues et les voix

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/voice-options"

Générer avec une voix sélectionnée

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-quick-voice",
  "text": "Bonjour. Ceci est un test.",
  "language": "fr-FR",
  "voice": "fr-FR-DeniseNeural",
  "speed": 1,
  "pitch": 0,
  "volume": 1
}'

Générer avec la sélection automatique de la voix

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-quick-voice",
  "text": "Welcome to Imole.",
  "language": "en-US",
  "speed": 1
}'

Générer avec le minutage

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-quick-voice",
  "text": "Bonjour. Ceci est un test avec sous titres.",
  "with_subtitles": true,
  "language": "fr-FR",
  "voice": "fr-FR-DeniseNeural"
}'

Vérifier l’état de la tâche

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/jobs/$JOB_ID"

Télécharger le résultat

curl -L -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/jobs/$JOB_ID/content" -o imole-quick-voice.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é2 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érenceContrat du service vocal Imole et catalogue des voix