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

Provider API

Каталог моделей и OpenAI-совместимые запросы к LLM.

Provider API: модели и LLM

Единый минимальный API для приложений. SimpleClaw проверяет ключ, подписку и credits, а затем передаёт запрос во внутренний Model Gateway. До первого вызова прочитайте правила credits и ошибки.

GET/v1/modelsКаталог моделейПубличный

Доступ: Публичный

Запрос

Параметров нет.

Успешный ответ

{ "object": "list", "data": [{ "id": "model-id", "object": "model", "owned_by": "openai", "display_name": "Название", "pricing": { "inputCreditsPerMillion": 1, "outputCreditsPerMillion": 1, "cacheReadCreditsPerMillion": 0, "reasoningCreditsPerMillion": 0 } | null }] }

Перечень доступных моделей сервер получает из LLMRouter. Все значения pricing — credits за 1 млн токенов; null означает, что ставка пока не настроена.

GET/v1/models/favoritesСписок избранных моделейТребуется авторизация

Доступ: Сессия

Запрос

Нет.

Успешный ответ

JSON ответаПоказать

[
  "model-id"
]

Возвращает public ID моделей, которые пользователь отметил в кабинете.

PUT/v1/models/:publicId/favoriteДобавить модель в избранноеТребуется авторизация

Доступ: Сессия

Запрос

Path: publicId модели из каталога.

Успешный ответ

JSON ответаПоказать

{
  "favorite": true
}

Идемпотентная операция. Недоступная модель вернёт MODEL_UNAVAILABLE.

DELETE/v1/models/:publicId/favoriteУбрать модель из избранногоТребуется авторизация

Доступ: Сессия

Запрос

Path: publicId модели.

Успешный ответ

JSON ответаПоказать

{
  "favorite": false
}

Идемпотентная операция: удаляет отметку только текущего пользователя.

POST/v1/chat/completionsОтправить сообщение моделиТребуется авторизация

Доступ: Bearer API key

Запрос

JSON запросаПоказать

{
  "model": "model-id",
  "messages": [
    {
      "role": "user",
      "content": "Привет"
    }
  ],
  "max_tokens": 1024,
  "temperature": 0.7
}

Успешный ответ

JSON ответаПоказать

{
  "id": "chatcmpl_…",
  "object": "chat.completion",
  "created": 0,
  "model": "model-id",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "…"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 2
  }
}

Поддерживаются model, текстовые messages, max_tokens (1–32768) и temperature (0–2). Поле message временно доступно для обратной совместимости. Streaming и tools пока не поддерживаются.

POST/v1/messagesAnthropic Messages для Claude CodeТребуется авторизация

Доступ: Bearer или x-api-key

Запрос

Header: anthropic-version: 2023-06-01. Body: { "model": "anthropic-model-id", "max_tokens": 1024, "messages": [{ "role": "user", "content": "Привет" }], "stream": true }

Успешный ответ

{ "id": "msg_…", "type": "message", "role": "assistant", "content": [{ "type": "text", "text": "…" }], "stop_reason": "end_turn", "usage": { "input_tokens": 1, "output_tokens": 1 } } | Anthropic SSE

Только активные модели ANTHROPIC. Поддерживаются system, text/tool_use/tool_result blocks и конечный SSE для Claude Code; image/document/cache/thinking блоки вернут 400. Ключ проходит те же проверки доступа, credits и budget.

POST/v1/responsesOpenAI Responses для CodexТребуется авторизация

Доступ: Bearer API key

Запрос

JSON запросаПоказать

{
  "model": "model-id",
  "instructions": "…",
  "input": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Привет"
        }
      ]
    }
  ],
  "tools": [
    {
      "type": "function",
      "name": "read_file",
      "parameters": {}
    }
  ],
  "stream": true
}

Успешный ответ

{ "id": "resp_…", "object": "response", "status": "completed", "output": [{ "type": "message", "role": "assistant", "content": [{ "type": "output_text", "text": "…" }] }], "usage": { "input_tokens": 1, "output_tokens": 1, "total_tokens": 2 } } | response.* SSE

Stateless transport для Codex: поддержаны message, function_call и function_call_output, function tools и завершающий SSE после settlement. previous_response_id, hosted tools, изображения и файлы вернут безопасный 400.