Câbler votre système à la plateforme Voice

Notre service expose un endpoint compatible OpenAI / VAPI custom-LLM : vous y envoyez une conversation, on répond dans la langue vernaculaire (le moteur traduit, raisonne en français pivot, et répond dans la langue cible). Vous gérez clé, langue, persona et solde depuis la console.

1. Obtenir une clé

Console → Clés APICréer une clé (affichée une seule fois) : vsk_….

2. Appeler l'endpoint

POST https://voice.bantou.ai/v1/chat/completions
Authorization: Bearer vsk_VOTRE_CLE
Content-Type: application/json

{"messages":[{"role":"user","content":"Naka nga def?"}]}

La réponse est au format OpenAI (choices[0].message.content), dans votre langue.

3. Choisir la langue

Ordre de priorité : en-tête X-Lang: wolof > champ "model":"wolof" > votre langue par défaut (profil) > défaut global. Réglez la langue par défaut dans le profil pour ne plus avoir à l'envoyer.

4. Définir le rôle (persona)

Envoyez un message role:system décrivant votre métier (ex. « Tu es un recruteur qui fait passer un entretien »). Si vous n'en envoyez pas, votre persona par défaut (profil) est utilisée. Le LLM raisonne en français et répond dans la langue cible.

5. VAPI (custom-LLM)

provider: custom-llm
url:      https://voice.bantou.ai/v1/chat/completions
model:    wolof            # le champ model route la langue
headers:  Authorization: Bearer vsk_VOTRE_CLE

Mettez votre prompt système (rôle) dans l'assistant VAPI : il nous arrive comme persona.

6. Solde & coupure

Chaque réponse renvoie X-Credit-Balance (solde, centimes XOF) et X-Credit-Charged (coût de l'appel). À solde épuisé : en mode message, on renvoie un 200 avec un texte parlable (idéal VAPI) ; en mode http402, un HTTP 402. Réglez le mode dans le profil. Rechargez via les packs (paiement Wave) dans la console.

← Retour à la console