API REST (Beta)

Documentation API

Intégrez la puissance de la synthèse vocale d'iziVoice directement dans vos applications, sites web ou workflows automatisés.

Base URL

https://www.izivoice.app/api/v1

Authentification

Toutes les requêtes vers l'API doivent être authentifiées à l'aide d'une clé d'API. Vous pouvez générer votre clé depuis la page Paramètres > Accès API.

Passez votre clé API dans le header Authorization de chaque requête :

Authorization: Bearer sk_prod_votre_cle_api_ici

POST

/generate

Convertit du texte en fichier audio (MP3).

Paramètres du Body (JSON)

text
Requis
Le texte à convertir en voix. (Max: 5000 caractères par requête).
voice_id
Requis
L'identifiant de la voix à utiliser (voir l'endpoint /voices).

Exemple de requête (cURL)

curl -X POST https://www.izivoice.app/api/v1/generate \
  -H "Authorization: Bearer sk_prod_..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Bonjour tout le monde !",
    "voice_id": "cheikh_sn"
  }'

Réponse (200 OK)

{
  "success": true,
  "audio_url": "https://storage.izivoice.app/...",
  "credits_used": 23,
  "remaining_credits": 9977
}

GET

/voices

Récupère la liste de toutes les voix disponibles et leurs identifiants.

Aucun paramètre n'est requis pour cette requête.

Réponse (200 OK)

{
  "success": true,
  "voices": [
    {
      "voice_id": "cheikh_sn",
      "name": "Cheikh",
      "accent": "Sénégalais",
      "gender": "male"
    },
    ...
  ]
}