Справочник 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 сам по себе не доказывает, что реальная генерация включена.