API 参考
支持的公开推理端点及请求字段。下载 OpenAPI 文档以获取机器可读架构。
端点
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | /v1/models | 列出已启用且已审核的模型。 |
| GET | /v1/models/{model_id} | 读取一个已审核模型。 |
| POST | /v1/chat/completions | 生成 JSON 响应或 SSE 流。 |
| GET | /health | Worker 存活状态。 |
| GET | /ready | 数据库与推理就绪状态。 |
聊天请求
POST /v1/chat/completions
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}'请求体需要模型 ID 和消息。只能设置 max_tokens 或 max_completion_tokens 中的一个。聊天请求上限为 4 MiB；提供商负责限制输入上下文和工具。
响应
非流式调用返回 OpenAI 兼容聊天响应。流式调用返回 SSE 增量，以 data: [DONE] 结束。最终财务结算前必须验证用量。
| 请求头 / 字段 | 用途 |
|---|---|
| 授权 | 应用 Bearer 密钥。 |
| Content-Type | 请求使用 application/json。 |
| Idempotency-Key | 可选防重复引用。 |
| x-request-id | 用于调查的响应引用。 |
| usage | 结算采用的提供商令牌数。 |
健康与就绪状态
GET /health 检查存活状态。GET /ready 还检查依赖及推理就绪状态；服务不可用或受上线条件限制时可能返回 503。Worker 正常本身不能证明真实推理已启用。