Обзор API

Адрес и авторизация

Base URL:      https://api.plexxum.ru/v1
Authorization: Bearer <ваш ключ>
Content-Type:  application/json

Ключ создаётся в разделе «Ключи» кабинета. Клиенты Anthropic могут передавать его в заголовке x-api-key.

Запросы

Метод	Путь	Что делает
GET	/v1/models	Каталог моделей с ценами в рублях. Ключ не нужен, баланс не тратит.
POST	/v1/chat/completions	Ответ модели в формате OpenAI Chat Completions, в том числе потоком.
POST	/v1/responses	Ответ модели в формате OpenAI Responses, в том числе потоком.
POST	/anthropic/v1/messages	Ответ модели в формате Anthropic Messages, в том числе потоком.
GET	/anthropic/v1/models	Список моделей в формате Anthropic, с ключом.

Другие адреса — эмбеддинги, изображения, пакетные и фоновые запросы — отвечают ошибкой 404.

Пример

curl https://api.plexxum.ru/v1/chat/completions \
  -H "Authorization: Bearer $PLEXXUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","messages":[{"role":"user","content":"Привет!"}]}'

Стоимость в ответе

В ответе без потока поле usage.cost — стоимость запроса в рублях:

"usage": {
  "prompt_tokens": 12,
  "completion_tokens": 48,
  "total_tokens": 60,
  "cost": 0.0123
}

В потоковом ответе usage.cost нет: стоимость каждого запроса видна в журнале запросов кабинета.

Потоковый ответ

Передайте "stream": true: ответ придёт частями в формате server-sent events, как у OpenAI или Anthropic. SDK обрабатывают это сами.

Ограничения

• Имя модели — id из каталога, без имени поставщика: anthropic/claude-sonnet-5-5 получит ошибку 400.
• В /v1/responses не поддерживаются previous_response_id, conversation, background, prompt и container; инструменты, которые исполняет поставщик (поиск в интернете, исполнение кода, mcp_servers), — тоже 400. Подробнее — в статье Claude Code и Codex.
• Ответ не длиннее потолка модели: если max_tokens больше, Plexxum уменьшит его до потолка.
• Каждый ответ несёт заголовок X-Request-ID. Он же — в ошибках и, для принятых запросов, в журнале кабинета. Отказы Plexxum до вызова модели (400, 401, 402, 403, 404, 413, 429) в журнал не попадают — сохраните id из ответа; ошибки поставщика в журнале есть.

Коды ошибок — в статье Ошибки ключа, модели и баланса.