Referência da API
Os endpoints de inferência pública e os campos de solicitação suportados. Baixe o documento OpenAPI para obter esquemas legíveis por máquina.
Endpoints
| Método | Caminho | Finalidade |
|---|---|---|
| GET | /v1/models | Listar modelos habilitados e aprovados. |
| GET | /v1/models/{model_id} | Consultar um modelo aprovado. |
| POST | /v1/chat/completions | Gere uma resposta JSON ou um fluxo SSE. |
| GET | /health | Estado de funcionamento do Worker. |
| GET | /ready | Prontidão do banco de dados e da inferência. |
Solicitação 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}'O corpo exige um ID de modelo e mensagens. Use max_tokens ou max_completion_tokens, não ambos. Solicitações de chat são limitadas a 4 MiB; o provedor aplica os limites de contexto de entrada e ferramentas.
Resposta
Chamadas sem streaming retornam uma resposta de chat compatível com OpenAI. Chamadas com streaming retornam deltas SSE que terminam em data: [DONE]. O uso deve ser verificado antes da liquidação financeira final.
| Cabeçalho / campo | Finalidade |
|---|---|
| Autorização | Chave de aplicação Bearer. |
| Content-Type | application/json para solicitações. |
| Idempotency-Key | Referência opcional para evitar duplicações. |
| x-request-id | Referência da resposta para investigação. |
| usage | Contagens de tokens do provedor usadas na liquidação. |
Integridade e prontidão
GET /health verifica o funcionamento. GET /ready também verifica as dependências e a prontidão da inferência; pode retornar 503 enquanto o serviço estiver indisponível ou bloqueado pelos requisitos de lançamento. Um Worker em bom estado, por si só, não comprova que a inferência em produção está habilitada.