ZCode с apmix
ZCode начинает работать с вашим ключом apmix примерно за 2 мин. Вставьте ключ один раз, и все примеры кода ниже будут готовы к копированию с любой моделью из каталога.
Базовые 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.
Ваша конфигурация
Получить ключ →- base_url
- https://api.apmix.ai/v1
- api_key
- apx_live_YOUR_KEY
- model
- glm-5.3
Откройте настройки моделей
Откройте список моделей внизу окна, нажмите «Manage models», выберите провайдера и в правом верхнем углу переключите его в режим «API Key».
Укажите базовый URL
Для протокола OpenAI используйте URL OpenAI, а для моделей Claude — URL Anthropic.
ЗначенияOpenAI Base URL https://api.apmix.ai/v1 Anthropic Base URL https://api.apmix.aiВставьте ключ и добавьте модель
Вставьте ключ apmix, нажмите «Add Model» и введите точный ID модели. ZCode хранит эти настройки в
~/.zcode/v2/config.json.ЗначенияAPI key apx_live_YOUR_KEY Model glm-5.3Вставьте ключ выше, чтобы подставить его сюда
Проверка
Убедитесь, что ключ работает.
Запросите список моделей, доступных вашему ключу. Если в ответ пришёл список в 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 модели из каталога.
Как вызвать API напрямуюВсё ещё не получается? Напишите на support@apmix.ai, указав название инструмента и ID запроса.
Ошибки
Каждая ошибка, её HTTP-статус и что делать.
API отвечает стандартным HTTP-статусом и JSON-телом с названием ошибки. Поле code никогда не меняется, поэтому ошибки удобно проверять по нему; поле message написано для людей. Каждый ответ также содержит заголовок x-apmix-request-id — укажите его, когда будете писать на support@apmix.ai.
Два формата в зависимости от эндпоинта
/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
}
}/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
invalid_jsoninvalid_request_error
Когда возникает: Тело запроса не удалось разобрать как JSON.
Что делать: Проверьте кавычки, запятые и заголовок
Content-Type: application/json. - 400
missing_modelinvalid_request_error
Когда возникает: В запросе нет поля
model.Что делать: Добавьте ID модели из каталога, например
claude-sonnet-4-6. - 400
bad_requestinvalid_request_error
Когда возникает: Модель отклонила параметр (неверный тип, неподдерживаемая опция, слишком длинное содержимое).
Что делать: Прочитайте
message: там повторяется причина, которую назвала модель. Исправьте параметр и отправьте запрос снова.
- 401
missing_api_keyauthentication_error
Когда возникает: Ключ не передан. Он нужен для любого эндпоинта, включая
GET /v1/models, потому что каталог зависит от вашего тарифа.Что делать: Передайте заголовок
Authorization: Bearer apx_live_…(илиx-api-keyна Anthropic-совместимых эндпоинтах). - 401
invalid_api_keyauthentication_error
Когда возникает: Ключ не существует или был удалён.
Что делать: Скопируйте его заново в разделе «Панель управления → API-ключи» или создайте новый.
- 401
key_expiredauthentication_error
Когда возникает: Истёк срок действия, заданный вами при создании ключа.
Что делать: Создайте новый ключ: срок действия продлить нельзя.
- 403
model_not_in_planpermission_error
Когда возникает: Модель существует, но требует более высокого тарифа, или у аккаунта ещё нет тарифа. В
messageуказаны модель, нужный для неё тариф и тариф вашего ключа.Что делать: Вызовите
GET /v1/modelsс тем же ключом — в списке будут только модели вашего тарифа — или повысьте тариф в разделе «Панель управления → Оплата». - 403
account_suspendedpermission_error
Когда возникает: Аккаунт заблокирован за нарушение условий использования.
Что делать: Напишите на support@apmix.ai с адреса, привязанного к аккаунту.
- 403
account_on_holdpermission_error
Когда возникает: По аккаунту проверяется платёж; до окончания проверки запросы приостановлены.
Что делать: С вашей стороны ничего не требуется. Следите за почтой или напишите на support@apmix.ai, если проверка займёт больше суток.
- 404
model_not_foundnot_found_error
Когда возникает: ID модели неизвестен, или модель больше не поддерживается.
Что делать: Используйте ID из
/v1/modelsили со страницы «Модели». Префиксы провайдеров вродеanthropic/тоже принимаются. - 404
not_foundnot_found_error
Когда возникает: Такого пути или метода не существует.
Что делать: Используйте
POST /v1/chat/completions,POST /v1/responses,POST /v1/messages,GET /v1/modelsилиGET /v1/usage.
- 429
allowance_exhaustedinsufficient_quota · rate_limit_error
Когда возникает: Месячная квота взвешенных токенов исчерпана. Поле
typeравноinsufficient_quota, как у OpenAI.Что делать: Повысьте тариф в разделе «Панель управления → Оплата» или дождитесь даты продления, указанной на странице «Обзор».
- 429
daily_limit_reachedrate_limit_error
Когда возникает: Вы достигли дневного лимита, который сами задали в разделе «Настройки → Лимиты».
Что делать: Увеличьте или снимите лимит либо дождитесь полуночи по UTC.
- 429
weekly_limit_reachedrate_limit_error
Когда возникает: Вы достигли недельного лимита, который сами задали в разделе «Настройки → Лимиты».
Что делать: Увеличьте или снимите лимит либо дождитесь понедельника, 00:00 UTC.
- 429
key_limit_reachedinsufficient_quota · rate_limit_error
Когда возникает: Ключ исчерпал лимит расхода, который владелец задал ему в разделе Панель → API-ключи.
type—insufficient_quota.Что делать: Попросите владельца ключа повысить или снять лимит расхода — ключ сразу заработает снова.
- 429
rate_limit_exceededrate_limit_error
Можно повторитьКогда возникает: Больше 60 запросов за минуту с одного ключа (на Max — 120).
Что делать: Подождите столько секунд, сколько указано в
retry-after. Распределяйте тяжёлые задачи между несколькими ключами. - 429
upstream_rate_limitedrate_limit_error
Можно повторитьКогда возникает: Сама модель сейчас перегружена.
Что делать: Повторите запрос, постепенно увеличивая паузу (1 с, 2 с, 4 с). Ничего не списано.
- 502
upstream_errorapi_error
Можно повторитьКогда возникает: Модель вернула некорректный или неожиданный ответ.
Что делать: Попробуйте ещё раз; если ошибка повторится, выберите другую модель. Ничего не списано.
- 503
upstream_unavailableapi_error · overloaded_error
Можно повторитьКогда возникает: Модель не ответила вовремя или недоступна из-за технических работ.
Что делать: Повторите запрос чуть позже или смените модель. Ничего не списано.
- 503
no_providerapi_error · overloaded_error
Можно повторитьКогда возникает: У нас сейчас нет активного маршрута к этой модели (бывает редко, во время технических работ).
Что делать: Повторите запрос через несколько минут или выберите другую модель.
Ошибки с пометкой «можно повторить» временные: подождите секунду-другую и отправьте тот же запрос ещё раз (большинство SDK делают это автоматически при 429 и 5xx). Во всех остальных случаях сначала нужно что-то изменить на вашей стороне.
Полезные заголовки ответа
- x-apmix-request-id
- Уникальный ID этого запроса. Указывайте его в письмах на support@apmix.ai.
- x-apmix-remaining
- Сколько взвешенных токенов осталось в вашей месячной квоте после этого запроса.
- x-apmix-key-remaining
- Сколько взвешенных токенов осталось у ключа, если у него есть лимит расхода.
- x-apmix-weighted-tokens
- Стоимость этого запроса с учётом множителя модели.
- retry-after
- Сколько секунд нужно подождать; приходит вместе с
rate_limit_exceeded.