Sviluppatori
Porta l’assistente nella tua app, nel tuo client MCP o sul tuo sito. Ovunque costa come nella chat.
POST/api/v1/conversations
Avvia una chat: { text, locale?, model?, tools? } — con tools crea immagini, video, musica o voce.
curl -X POST "https://bilgisam.com/api/v1/conversations" \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text":"…","locale":"it"}'Corpo della risposta
La risposta apparirà qui.
Documentazione
API REST
JSON in entrata e in uscita. Le risposte si scrivono in background: invia il messaggio, poi leggi la chat finché `pending` è false.
POST/api/v1/conversationsAvvia una chat: { text, locale?, model?, tools? } — con tools crea immagini, video, musica o voce.POST/api/v1/conversations/{id}Aggiungi un messaggio: { text, locale?, model?, tools? }GET/api/v1/conversations/{id}Ultimi messaggi e stato `pending`GET/api/v1/conversationsLe tue chat recentiGET/api/v1/creditsI tuoi crediti rimanentiGET/api/v1/toolsStrumenti disponibili e costi
curl -X POST https://bilgisam.com/api/v1/conversations \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{"text": "Merhaba", "locale": "it"}'
# → {"id": "…"} — leggi la risposta qualche secondo dopo
curl https://bilgisam.com/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."Campi facoltativi: instructions (istruzioni di sistema per questo turno, fino a 20.000 caratteri; inviale a ogni richiesta), private (true → 402 needs-private se il tuo piano non consente chat private). Le risposte dell’API non usano il ragionamento (thinking): rapide e a costo fisso.
Errori: 401 chiave non valida · 402 crediti insufficienti o serve Pro · 409 risposta precedente in corso o serve il consenso · 429 limite di frequenza.