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ètre | Free | Pro |
|---|---|---|
| Formats audio | WAV, MP3, M4A, OGG | WAV, MP3, M4A, OGG |
| Taille max fichier | 25 MB | 100 MB |
| Durée max | 10 min / jour | 2h / jour |
| Requêtes max | 100 / jour | 1 000 / jour |
| Timeout | 30s | 120s |