Essayer

Afficher les prix en

FCFA KMF EUR USD MAD
Créer mon assistant gratuitement Se connecter

Votre assistant, dans votre application.

Une requête, une réponse sourcée. Mêmes documents, même consigne et mêmes garde-fous que sur votre site : appelez-le depuis votre appli mobile, votre back-office ou votre serveur.

Obtenir ma clé d'API Voir un exemple
  • Une clé secrète par assistant, révocable en un clic
  • Chaque réponse cite ses sources et dit quand elle ne sait pas
  • Quota et consommation visibles en direct
POST /api/v1/chat 
curl https://kouma.site/api/v1/chat \
  -H "Authorization: Bearer kma_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"message": "Vous livrez à Bobo ?", "conversation_id": "client-4821"}'
const res = await fetch('https://kouma.site/api/v1/chat', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer kma_votre_cle',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ message: 'Vous livrez à Bobo ?', conversation_id: 'client-4821' }),
});
const { answer, sources, usage } = await res.json();

Trois étapes, dix minutes.

  1. Créez l'assistant

    Ajoutez vos documents, votre site ou vos photos, comme pour un assistant classique. Testez-le dans la zone de test.

  2. Générez une clé

    Dans votre espace, page « Développeurs » : une clé par assistant, montrée une seule fois, révocable à tout moment.

  3. Appelez l'API

    Envoyez un message, recevez la réponse, ses sources et votre consommation. Gardez le même conversation_id pour suivre un fil.

Une réponse qui se vérifie.

L'assistant répond d'après vos documents et le dit : grounded vaut false quand il n'a pas trouvé l'information, et handoff passe à true quand un humain doit reprendre.

{
  "conversation_id": "client-4821",
  "answer": "Oui, à Bobo-Dioulasso : 2 000 FCFA, livré sous 48 h.",
  "grounded": true,
  "handoff": false,
  "suggestions": ["Commander", "Autres villes"],
  "sources": [{ "title": "Livraison", "url": "https://boutique.example/livraison" }],
  "usage": { "answers_used": 128, "answers_limit": 3000 }
}

Erreurs et limites

401

missing_key, invalid_key

La clé manque, est inconnue ou a été révoquée.

403

plan_required, account_suspended

L'offre n'inclut pas l'API, ou l'espace est suspendu.

422

validation

Le message est vide ou trop long (2 000 caractères au plus).

429

quota_exceeded

Le quota de réponses du mois est atteint. Le champ usage donne la date de remise à zéro.

429

trop de requêtes

60 requêtes par minute et par clé : réessayez après quelques secondes.

Quelle que soit l'erreur, la réponse est un objet { "error": { "code", "message" } }.

Une offre simple, dans votre monnaie.

Vous payez un forfait mensuel, avec un volume de réponses inclus. Au-delà, écrivez-nous : nous adaptons l'offre à votre usage.

FCFA KMF EUR USD MAD

API Développeur

Intégrez l'assistant dans votre application

330 DH par mois

  • 3 000 réponses par mois via l'API
  • 3 assistants, une clé chacun
  • 40 sources de connaissances
  • 3 utilisateurs
  • Consommation en direct, clés révocables
  • WhatsApp et widget de chat
Choisir API Développeur