Modèle · Audio

Imole TTS

Transformez votre texte en audio : une langue ou plusieurs dans le même enregistrement, voix Premium et Standard, clonage personnel et téléchargement.

Identifiant du modèleimole-tts

Route API POST /audio/speech

Tester dans le Laboratoire

Présentation du modèle

Ce que fait ce modèle

Imole TTS transforme un texte en fichier audio prêt à écouter et à télécharger.

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

Narrations, voix off et contenus pédagogiques.
Messages courts et annonces multilingues.

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.

01
Texte
Écrivez pour l’oreille : phrases courtes, ponctuation naturelle et prononciation explicite si nécessaire.
02
Interprète
Choisissez une voix dans la liste et la langue du texte.
03
Interprétation
Sélectionnez Naturel ou un style proposé pour la voix. Le champ Texte contient uniquement les mots à prononcer.
04
Sortie
Choisissez MP3 pour partager, WAV pour monter ou Opus pour compresser.

Exemple 1

Une introduction accueillante

Bonjour et bienvenue. Aujourd’hui, nous allons découvrir trois façons simples de mieux organiser notre semaine.

Le texte contient les mots à prononcer. La ponctuation aide à structurer la lecture.

Réglages

Contrôles disponibles dans Imọlẹ

Plusieurs langues

La case désactive le choix de langue et propose les voix Premium multilingues. Chaque passage reste dans sa langue ; aucun texte n’est traduit.

Voix et langue

La liste affiche uniquement les voix de la langue sélectionnée. Premium en premier, puis Standard et vos voix privées.

Style

Naturel par défaut. Les autres styles dépendent de la voix.

Format

Formats selon la voix : Premium MP3/WAV/Opus, Standard MP3, privée MP3/WAV.

API

Intégrer le modèle dans un projet

MéthodePOST

Chemin/audio/speech

URL de basehttps://api.imole.app/v1

Coût APIPremium 10 · Standard 5 · privée 20 cauris / 1 000 caractères

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

Identifiant public.

imole-tts

inputRequis

Texte à prononcer, 4 000 caractères maximum ou 1 000 pour une voix privée. Les espaces aux extrémités sont ignorés.

—

voice

Identifiant de voix. Soleil par défaut ; consultez GET /audio/voices. Pour une voix privée, utilisez profile.id retourné par /audio/voice-profiles une fois son statut ready.

fr-FR-Soleil, fr-FR-Marc…

multilingual

Plusieurs langues dans le même audio, avec une seule voix Premium. Consultez /audio/voices?multilingual=true. Omettez language dans ce mode.

true, false

language

Hors mode multilingue : langue de lecture. Par défaut, langue principale de la voix. Utilisez un code de sa liste languages.

fr-FR, en-US…

style

Style expressif parmi ceux de la voix. neutral par défaut.

neutral, happy, sad… selon la voix

response_format

MP3 par défaut ; Standard MP3 uniquement, Premium MP3/WAV/Opus, privée MP3/WAV.

mp3, wav, opus

speed / pitch / volume

Voix Standard compatibles : vitesse 0,5–2 ; tonalité −50 à 50 ; volume 0–100.

—

slow

Lecture lente pour les voix Standard qui proposent ce réglage.

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.

Créer une voix en français

curl https://api.imole.app/v1/audio/speech \
  -H 'Authorization: Bearer YOUR_IMOLE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model":"imole-tts","input":"Bonjour et bienvenue sur Imole.","voice":"fr-FR-Soleil","language":"fr-FR","style":"happy","response_format":"mp3"}' \
  --output voix.mp3

Plusieurs langues, une seule 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-tts",
  "input": "Bonjour. Hello. Hola.",
  "multilingual": true,
  "voice": "multilingual-coral",
  "response_format": "mp3"
}' --output multilingue.mp3

Voix pour mélanger les langues

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/audio/voices?multilingual=true"

Consulter les voix et les styles

curl https://api.imole.app/v1/audio/voices

Créer une voix Standard

curl -X POST "https://api.imole.app/v1/audio/speech" \
  -H "Authorization: Bearer $IMOLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "imole-tts",
  "input": "Bonjour et bienvenue sur Imole.",
  "voice": "fr-FR-DeniseNeural",
  "language": "fr-FR",
  "speed": 1,
  "response_format": "mp3"
}'

Suivre la demande (jusqu’à completed)

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/media/jobs/{jobId}"

Récupérer le résultat après completed

curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/media/jobs/{jobId}/content"

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éPremium 10 · Standard 5 · privée 20 cauris / 1 000 caractères

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 Imole TTS et catalogue de voix vérifié