AccueilDocumentation
Documentation

Getting Started

Intégrez AfriVoice en 5 minutes. L'API accepte des fichiers audio (WAV, MP3, M4A, OGG) ou des URLs YouTube et retourne la transcription avec détection de code-switching.

En 3 étapes

01

Créer votre clé API

Inscrivez-vous gratuitement et générez votre première clé depuis le tableau de bord.

Créer un compte →
02

Appeler l'API

Envoyez un fichier audio en multipart/form-data avec votre clé dans le header X-API-Key.

Voir la référence →
03

Recevoir la transcription

La réponse JSON contient le texte, les segments horodatés et les ratios de code-switching.

Format de réponse →

Premier appel — Python

import requests

API_KEY = "av_votre_clé_api"
BASE_URL = "https://api.afrivoice.xelsoftai.com/v1"

# Transcrire un fichier audio
with open("audio.wav", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/transcribe",
        headers={"X-API-Key": API_KEY},
        files={"file": f},
    )

result = response.json()
print(result["data"]["text"])
# → "Maangi dem ci ndéy bi..."

Avec cURL

curl -X POST https://api.afrivoice.xelsoftai.com/v1/transcribe \
  -H "X-API-Key: av_votre_clé_api" \
  -F "file=@audio.wav"

Avec JavaScript / TypeScript

const form = new FormData();
form.append('file', audioFile);

const res = await fetch(
  'https://api.afrivoice.xelsoftai.com/v1/transcribe',
  {
    method: 'POST',
    headers: { 'X-API-Key': 'av_votre_clé_api' },
    body: form,
  }
);

const { data } = await res.json();
console.log(data.text); // → "Maangi dem..."

Format de réponse

{
  "success": true,
  "data": {
    "request_id": "req_abc123",
    "text": "Maangi dem ci ndéy bi. Il faut partir maintenant.",
    "duration_s": 4.2,
    "model": "whisper-wolof-v1",
    "cs_languages": ["wo", "fr"],
    "cs_wolof_ratio": 0.72,
    "cs_french_ratio": 0.28,
    "segments": [
      { "start_s": 0.0, "end_s": 2.1, "text": "Maangi dem ci ndéy bi." },
      { "start_s": 2.1, "end_s": 4.2, "text": "Il faut partir maintenant." }
    ]
  }
}

Langues supportées

🇸🇳

Wolof

wo

🇸🇳

Pulaar

pu

🇸🇳

Sérère

sr

🇸🇳

Diola

dj

🌍

Français

fr

🌍

Arabe

ar

🌍

Anglais

en

Limites et formats

ParamètreFreePro
Formats audioWAV, MP3, M4A, OGGWAV, MP3, M4A, OGG
Taille max fichier25 MB100 MB
Durée max10 min / jour2h / jour
Requêtes max100 / jour1 000 / jour
Timeout30s120s