CloseRouter API

Документация CloseRouter API

Короткая документация по публичному inference API: модели, запросы, ключи, баланс и ошибки.

Скачать .mdAPI-ключиМодели
Base URL
https://api.closerouter.dev/v1
Авторизация
Authorization: Bearer closerouter_...
Каталог
GET /models

Ошибки

Все ошибки возвращаются в одном JSON-формате.

Error JSON

JSON
{
  "error": {
    "code": "invalid_request",
    "message": "Request body must be a JSON object",
    "status": 400,
    "metadata": {
      "request_id": "..."
    }
  }
}

Частые коды

  • 400 invalid_request: неверный JSON, отсутствует model, неподдерживаемый параметр или смешаны бесплатные и платные fallback-модели.
  • 401 invalid_api_key: нет ключа или ключ неверный.
  • 402 insufficient_balance: недостаточно средств.
  • 403 telegram_link_required: привяжите Telegram на /settings перед использованием бесплатной модели.
  • 429 rate_limited: лимит запросов временно исчерпан; для дневного лимита бесплатных моделей metadata.limit_type = free_models_daily_requests, а Retry-After показывает секунды до полуночи UTC.
  • 503 no_available_provider: для выбранной модели и endpoint сейчас нет доступного маршрута.
  • 503 service_unavailable: проверка доступа к бесплатной модели временно недоступна и запрос отклонен без вызова провайдера.
  • metadata.request_id пригодится при обращении в поддержку.