Справочник API

Базовый URL — https://rezon-ai.ru/v1. Все запросы требуют заголовок Authorization: Bearer rz-sk-… (или x-api-key: rz-sk-…).

GET /v1/models

Список доступных моделей.

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-5",
      "object": "model",
      "owned_by": "rezon",
      "credits_per_msg": 100,
      "model_id": "anthropic/claude-sonnet-5",
      "category": "text",
      "context_length": 1000000,
      "modalities": { "input": ["text", "image"], "output": ["text"] }
    }
  ]
}

id / model_id — то, что передаётся в поле model запроса (сырой id вида вендор/модель).
credits_per_msg — ориентировочная стоимость типового сообщения в кредитах (реальное списание — по фактическим токенам).
category — text | image | free.

POST /v1/chat/completions

OpenAI-совместимый. Тело:

type Request = {
  model: string;              // id из GET /v1/models
  messages: { role: "system" | "user" | "assistant"; content: string }[];
  stream?: boolean;           // по умолчанию false
  max_tokens?: number;        // верхний предел ответа; жёсткий кап — 8192
  temperature?: number;
};

Ответ (не-стрим) — chat.completion с choices[0].message.content и блоком usage (prompt_tokens, completion_tokens, total_tokens). При stream: true — SSE-поток чанков chat.completion.chunk, последний кадр — data: [DONE].

Модели с category: "image" возвращают картинку внутри текста ответа как ![image](data:image/...).

POST /v1/messages

Anthropic-совместимый (для Claude Code и Anthropic SDK). Тело:

type Request = {
  model: string;
  messages: { role: "user" | "assistant"; content: string | Block[] }[];
  system?: string | Block[];
  max_tokens?: number;
  stream?: boolean;
};

Ответ — объект message с content: [{ type: "text", text: "…" }] и usage (input_tokens, output_tokens). При stream: true — Anthropic-события (message_start, content_block_delta, message_delta, message_stop).

Лимиты

	Значение
Частота	60 запросов в минуту на ключ
Максимум токенов ответа	8192 (кап на стороне сервера)
Размер ключей	до 10 активных ключей на аккаунт

Коды ошибок

Код	Значение
`401`	ключ отсутствует, не в формате `rz-sk-…`, отозван
`402`	недостаточно кредитов — пополните баланс
`404`	модель не найдена — сверьтесь с `GET /v1/models`
`422`	пустой `messages`
`429`	превышен лимит частоты
`502`	ошибка апстрим-провайдера (кредиты не списываются)

В стриминге ошибки приходят кадром {"error": {"message": "...", "type": "..."}} (OpenAI-эндпоинт) или событием error (Anthropic-эндпоинт).

Не поддерживается сейчас

Проксируется только текст (и картинки на выход у image-моделей). tools / function calling, response_format, приём изображений на вход и плагины пока не пробрасываются — планируется. Следите за обновлениями этой страницы.