Referencia de la API
Los endpoints de inferencia pública y campos de solicitud admitidos. Descarga el documento OpenAPI para obtener esquemas legibles por máquinas.
Endpoints
| Método | Ruta | Finalidad |
|---|---|---|
| GET | /v1/models | Enumerar los modelos habilitados y aprobados. |
| GET | /v1/models/{model_id} | Consultar un modelo aprobado. |
| POST | /v1/chat/completions | Genera una respuesta JSON o un flujo SSE. |
| GET | /health | Estado de funcionamiento del Worker. |
| GET | /ready | Disponibilidad de la base de datos y de la inferencia. |
Solicitud de chat
curl "https://uncensoredlabs.dev/v1/chat/completions" \
-H "Authorization: Bearer $UNCENSOREDLABS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"YOUR_APPROVED_MODEL_ID","messages":[{"role":"user","content":"Hello"}],"max_tokens":256}'Se requieren un ID de modelo y mensajes. Usa max_tokens o max_completion_tokens, no ambos. Las solicitudes de chat se limitan a 4 MiB; el proveedor aplica los límites de contexto de entrada y herramientas.
Respuesta
Las llamadas sin streaming devuelven una respuesta de chat compatible con OpenAI. Las llamadas con streaming devuelven deltas SSE que terminan en data: [DONE]. El uso debe verificarse antes de la liquidación financiera final.
| Encabezado / campo | Finalidad |
|---|---|
| Autorización | Clave de aplicación Bearer. |
| Content-Type | application/json para las solicitudes. |
| Idempotency-Key | Referencia opcional para evitar duplicados. |
| x-request-id | Referencia de respuesta para investigación. |
| usage | Recuentos de tokens del proveedor utilizados en la liquidación. |
Estado y disponibilidad
GET /health comprueba el funcionamiento. GET /ready comprueba además las dependencias y la disponibilidad de la inferencia; puede devolver 503 mientras el servicio no esté disponible o esté bloqueado por los requisitos de lanzamiento. Que un Worker funcione correctamente no demuestra por sí solo que la inferencia en producción esté habilitada.