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.

Chiave APIAccediAuthorization: Bearer

textmodel

tools

Attendi la risposta

Richiesta reale: il messaggio si paga con i tuoi crediti. (1 credito)

Codice

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 recenti
GET/api/v1/creditsI tuoi crediti rimanenti
GET/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.