Développeurs

Intégrez l’assistant à votre app, à votre client MCP ou à votre site. Partout, le coût est le même que dans le chat.

POST/api/v1/conversations

Démarrer une discussion : { text, locale?, model?, tools? } — avec tools, créez images, vidéo, musique ou voix.

Clé APISe connecterAuthorization: Bearer

textmodel

tools

Attendre la réponse

Requête réelle : le message est débité de vos crédits. (1 crédit)

Code

curl -X POST "https://bilgisam.com/api/v1/conversations" \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"…","locale":"fr"}'

Corps de la réponse

La réponse s’affichera ici.

Documentation

API REST

JSON en entrée et en sortie. Les réponses s’écrivent en arrière-plan : envoyez le message, puis lisez la discussion jusqu’à `pending` false.

POST/api/v1/conversationsDémarrer une discussion : { text, locale?, model?, tools? } — avec tools, créez images, vidéo, musique ou voix.
POST/api/v1/conversations/{id}Ajouter un message : { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Derniers messages et état `pending`
GET/api/v1/conversationsVos discussions récentes
GET/api/v1/creditsVos crédits restants
GET/api/v1/toolsOutils disponibles et coût en crédits

curl -X POST https://bilgisam.com/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "fr"}'
# → {"id": "…"}  — lisez la réponse quelques secondes plus tard
curl https://bilgisam.com/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

Champs facultatifs : instructions (instructions système pour ce tour, jusqu’à 20 000 caractères ; à renvoyer à chaque requête), private (true → 402 needs-private si ton offre n’autorise pas les discussions privées). Les réponses de l’API n’utilisent pas le raisonnement (thinking) : rapides et à coût fixe.

Erreurs : 401 clé invalide · 402 crédits insuffisants ou Pro requis · 409 réponse précédente en cours ou consentement requis · 429 limite de débit.