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

Две строки. Любой инструмент.

Каждому инструменту ниже нужно одно и то же: базовый URL apmix и ваш API-ключ. Вставьте ключ один раз — и все примеры кода на этой странице можно сразу копировать.

Базовые URL

https://api.apmix.ai/v1OpenAI-совместимый
Chat Completions и Responses. Для Codex, Cursor, OpenCode, Kilo Code, Pi, Kimi, Grok, Hermes и SDK.
https://api.apmix.aiAnthropic-совместимый
Messages API. Для Claude Code и SDK от Anthropic.

Ваша конфигурация

Получить ключ →

API-ключ

Ключ хранится только в этой вкладке и нужен лишь для подстановки в примеры кода на этой странице.

Модель

У каждого инструмента есть разумная модель по умолчанию. Можно выбрать любую другую из каталога.

base_url: https://api.apmix.ai
api_key: apx_live_YOUR_KEY
model: claude-sonnet-5

Выберите инструмент

Инструментов: 12

01
Установите Claude Code
Нужен Node.js 18 или новее. Если Claude Code уже есть на вашем компьютере, пропустите этот шаг.
Терминал
```
npm install -g @anthropic-ai/claude-code
```
02
Подключите Claude Code к apmix
Claude Code работает по протоколу Anthropic, поэтому базовый URL указывается без /v1. Задайте три переменные окружения в том терминале, из которого запускаете Claude Code.
```
export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"
```
Вставьте ключ выше, чтобы подставить его сюда
03
Сделайте настройки постоянными
Пропишите те же значения в ~/.claude/settings.json, чтобы каждый новый терминал был сразу готов к работе. Скрипт сначала делает резервную копию существующего файла; если у вас уже есть настройки, не заменяйте файл, а добавьте в них блок env.
~/.claude/settings.json
```
mkdir -p ~/.claude
[ -f ~/.claude/settings.json ] && cp ~/.claude/settings.json ~/.claude/settings.json.bak
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}
EOF
```
Вставьте ключ выше, чтобы подставить его сюда
04
Запускайте
Запустите Claude Code в папке проекта. Модель можно сменить в любой момент командой /model — подойдёт любой ID модели Claude из каталога.
Терминал
```
cd your-project
claude
```

Проверка

Убедитесь, что ключ работает.

Запросите список моделей, доступных вашему ключу. Если в ответ пришёл список в JSON, ключ и URL указаны верно; ответ 401 означает, что ключ неверный или его срок действия истёк.

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Вставьте ключ выше, чтобы подставить его сюда

Вашего инструмента нет в списке?

С apmix работает любой инструмент, в котором можно указать базовый URL для OpenAI или Anthropic. Найдите поле «Base URL» или «Custom provider», вставьте туда URL и ключ, а затем укажите ID модели из каталога.

Всё ещё не получается? Напишите на support@apmix.ai, указав название инструмента и ID запроса.

Ошибки

Каждая ошибка, её HTTP-статус и что делать.

API отвечает стандартным HTTP-статусом и JSON-телом с названием ошибки. Поле code никогда не меняется, поэтому ошибки удобно проверять по нему; поле message написано для людей. Каждый ответ также содержит заголовок x-apmix-request-id — укажите его, когда будете писать на support@apmix.ai.

Два формата в зависимости от эндпоинта

OpenAI-совместимые эндпоинты (/v1/chat/completions, /v1/responses, /v1/models, /v1/usage)

HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "error": {
    "message": "Your monthly allowance is used up. …",
    "type": "insufficient_quota",
    "code": "allowance_exhausted",
    "param": null
  }
}

Anthropic-совместимые эндпоинты (/v1/messages, /v1/messages/count_tokens)

HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Your monthly allowance is used up. …",
    "code": "allowance_exhausted"
  }
}

СтатусКодКогда возникаетЧто делать

400Неверный запрос

400
invalid_json
invalid_request_error
Когда возникает: Тело запроса не удалось разобрать как JSON.
Что делать: Проверьте кавычки, запятые и заголовок Content-Type: application/json.
400
missing_model
invalid_request_error
Когда возникает: В запросе нет поля model.
Что делать: Добавьте ID модели из каталога, например claude-sonnet-4-6.
400
bad_request
invalid_request_error
Когда возникает: Модель отклонила параметр (неверный тип, неподдерживаемая опция, слишком длинное содержимое).
Что делать: Прочитайте message: там повторяется причина, которую назвала модель. Исправьте параметр и отправьте запрос снова.

401Аутентификация

401
missing_api_key
authentication_error
Когда возникает: Ключ не передан. Он нужен для любого эндпоинта, включая GET /v1/models, потому что каталог зависит от вашего тарифа.
Что делать: Передайте заголовок Authorization: Bearer apx_live_… (или x-api-key на Anthropic-совместимых эндпоинтах).
401
invalid_api_key
authentication_error
Когда возникает: Ключ не существует или был удалён.
Что делать: Скопируйте его заново в разделе «Панель управления → API-ключи» или создайте новый.
401
key_expired
authentication_error
Когда возникает: Истёк срок действия, заданный вами при создании ключа.
Что делать: Создайте новый ключ: срок действия продлить нельзя.

403Права доступа

403
model_not_in_plan
permission_error
Когда возникает: Модель существует, но требует более высокого тарифа, или у аккаунта ещё нет тарифа. В message указаны модель, нужный для неё тариф и тариф вашего ключа.
Что делать: Вызовите GET /v1/models с тем же ключом — в списке будут только модели вашего тарифа — или повысьте тариф в разделе «Панель управления → Оплата».
403
event_not_started
permission_error
Когда возникает: Модель относится к акции сообщества, которая ещё не началась. Время начала указано в message.
Что делать: Дождитесь окончания обратного отсчёта на apmix.ai/event или пока воспользуйтесь другой моделью.
403
event_ended
permission_error
Когда возникает: Общий пул токенов акции израсходован, или акция завершена.
Что делать: Переключитесь на другую модель. О следующей акции объявят на apmix.ai/event.
403
account_suspended
permission_error
Когда возникает: Аккаунт заблокирован за нарушение условий использования.
Что делать: Напишите на support@apmix.ai с адреса, привязанного к аккаунту.
403
account_on_hold
permission_error
Когда возникает: По аккаунту проверяется платёж; до окончания проверки запросы приостановлены.
Что делать: С вашей стороны ничего не требуется. Следите за почтой или напишите на support@apmix.ai, если проверка займёт больше суток.

404Не найдено

404
model_not_found
not_found_error
Когда возникает: ID модели неизвестен, или модель больше не поддерживается.
Что делать: Используйте ID из /v1/models или со страницы «Модели». Префиксы провайдеров вроде anthropic/ тоже принимаются.
404
not_found
not_found_error
Когда возникает: Такого пути или метода не существует.
Что делать: Используйте POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, GET /v1/models или GET /v1/usage.

429Лимиты

429
allowance_exhausted
insufficient_quota · rate_limit_error
Когда возникает: Месячная квота взвешенных токенов исчерпана. Поле type равно insufficient_quota, как у OpenAI.
Что делать: Повысьте тариф в разделе «Панель управления → Оплата» или дождитесь даты продления, указанной на странице «Обзор».
429
daily_limit_reached
rate_limit_error
Когда возникает: Вы достигли дневного лимита, который сами задали в разделе «Настройки → Лимиты».
Что делать: Увеличьте или снимите лимит либо дождитесь полуночи по UTC.
429
weekly_limit_reached
rate_limit_error
Когда возникает: Вы достигли недельного лимита, который сами задали в разделе «Настройки → Лимиты».
Что делать: Увеличьте или снимите лимит либо дождитесь понедельника, 00:00 UTC.
429
rate_limit_exceeded
rate_limit_error
Можно повторить
Когда возникает: Больше 60 запросов за минуту с одного ключа.
Что делать: Подождите столько секунд, сколько указано в retry-after. Распределяйте тяжёлые задачи между несколькими ключами.
429
upstream_rate_limited
rate_limit_error
Можно повторить
Когда возникает: Сама модель сейчас перегружена.
Что делать: Повторите запрос, постепенно увеличивая паузу (1 с, 2 с, 4 с). Ничего не списано.

502Сбой провайдера

502
upstream_error
api_error
Можно повторить
Когда возникает: Модель вернула некорректный или неожиданный ответ.
Что делать: Попробуйте ещё раз; если ошибка повторится, выберите другую модель. Ничего не списано.

503Недоступно

503
upstream_unavailable
api_error · overloaded_error
Можно повторить
Когда возникает: Модель не ответила вовремя или недоступна из-за технических работ.
Что делать: Повторите запрос чуть позже или смените модель. Ничего не списано.
503
no_provider
api_error · overloaded_error
Можно повторить
Когда возникает: У нас сейчас нет активного маршрута к этой модели (бывает редко, во время технических работ).
Что делать: Повторите запрос через несколько минут или выберите другую модель.

Ошибки с пометкой «можно повторить» временные: подождите секунду-другую и отправьте тот же запрос ещё раз (большинство SDK делают это автоматически при 429 и 5xx). Во всех остальных случаях сначала нужно что-то изменить на вашей стороне.

Полезные заголовки ответа

x-apmix-request-id: Уникальный ID этого запроса. Указывайте его в письмах на support@apmix.ai.
x-apmix-remaining: Сколько взвешенных токенов осталось в вашей месячной квоте после этого запроса.
x-apmix-weighted-tokens: Стоимость этого запроса с учётом множителя модели.
retry-after: Сколько секунд нужно подождать; приходит вместе с rate_limit_exceeded.