Desarrolladores

Lleva el asistente a tu app, a tu cliente MCP o a tu web. En todas partes cuesta lo mismo que en el chat.

POST/api/v1/conversations

Iniciar conversación: { text, locale?, model?, tools? } — con tools genera imágenes, vídeo, música o voz.

Clave APIIniciar sesiónAuthorization: Bearer

textmodel

tools

Esperar la respuesta

Petición real: el mensaje se cobra de tus créditos. (1 crédito)

Código

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

Cuerpo de la respuesta

La respuesta aparecerá aquí.

Documentación

API REST

JSON de entrada y salida. Las respuestas se escriben en segundo plano: envía el mensaje y lee la conversación hasta que `pending` sea false.

POST/api/v1/conversationsIniciar conversación: { text, locale?, model?, tools? } — con tools genera imágenes, vídeo, música o voz.
POST/api/v1/conversations/{id}Añadir mensaje: { text, locale?, model?, tools? }
GET/api/v1/conversations/{id}Últimos mensajes y estado `pending`
GET/api/v1/conversationsTus conversaciones recientes
GET/api/v1/creditsTus créditos restantes
GET/api/v1/toolsHerramientas disponibles y su coste

curl -X POST https://bilgisam.com/api/v1/conversations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"text": "Merhaba", "locale": "es"}'
# → {"id": "…"}  — lee la respuesta unos segundos después
curl https://bilgisam.com/api/v1/conversations/{id} -H "Authorization: Bearer sk_..."

Campos opcionales: instructions (instrucciones de sistema para este turno, hasta 20.000 caracteres; envíalas en cada solicitud), private (true → 402 needs-private si tu plan no permite chats privados). Las respuestas de la API no usan razonamiento (thinking): rápidas y de coste fijo.

Errores: 401 clave no válida · 402 créditos insuficientes o requiere Pro · 409 respuesta anterior en curso o falta consentimiento · 429 límite de ritmo.