Перейти к содержимому
APMIX.AI

Любой SDK или curl с apmix

Любой SDK или curl начинает работать с вашим ключом apmix примерно за 1 мин. Вставьте ключ один раз, и все примеры кода ниже будут готовы к копированию с любой моделью из каталога.

Базовые 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
gpt-5.6-luna
  1. Отправьте запрос

    Те же пути и тот же JSON, что и у OpenAI. Меняются только хост и ключ.

    curl https://api.apmix.ai/v1/chat/completions \
      -H "Authorization: Bearer apx_live_YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"Say hello in five words."}]}'

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

  2. OpenAI SDK

    Измените base_url и api_key — всё остальное остаётся как есть.

    from openai import OpenAI
    
    client = OpenAI(base_url="https://api.apmix.ai/v1", api_key="apx_live_YOUR_KEY")
    
    reply = client.chat.completions.create(
        model="gpt-5.6-luna",
        messages=[{"role": "user", "content": "Say hello in five words."}],
    )
    print(reply.choices[0].message.content)

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

  3. Anthropic SDK

    Чтобы работать с моделями Claude по протоколу Anthropic, укажите в base_url Anthropic-совместимый URL.

    from anthropic import Anthropic
    
    client = Anthropic(base_url="https://api.apmix.ai", api_key="apx_live_YOUR_KEY")
    
    reply = client.messages.create(
        model="gpt-5.6-luna",
        max_tokens=256,
        messages=[{"role": "user", "content": "Say hello in five words."}],
    )
    print(reply.content[0].text)

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

Проверка

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

Запросите список моделей, доступных вашему ключу. Если в ответ пришёл список в 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.

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

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Неверный запрос
  • invalid_json

    invalid_request_error

    Когда возникает: Тело запроса не удалось разобрать как JSON.

    Что делать: Проверьте кавычки, запятые и заголовок Content-Type: application/json.

  • missing_model

    invalid_request_error

    Когда возникает: В запросе нет поля model.

    Что делать: Добавьте ID модели из каталога, например claude-sonnet-4-6.

  • bad_request

    invalid_request_error

    Когда возникает: Модель отклонила параметр (неверный тип, неподдерживаемая опция, слишком длинное содержимое).

    Что делать: Прочитайте message: там повторяется причина, которую назвала модель. Исправьте параметр и отправьте запрос снова.

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

    authentication_error

    Когда возникает: Ключ не передан. Он нужен для любого эндпоинта, включая GET /v1/models, потому что каталог зависит от вашего тарифа.

    Что делать: Передайте заголовок Authorization: Bearer apx_live_… (или x-api-key на Anthropic-совместимых эндпоинтах).

  • invalid_api_key

    authentication_error

    Когда возникает: Ключ не существует или был удалён.

    Что делать: Скопируйте его заново в разделе «Панель управления → API-ключи» или создайте новый.

  • key_expired

    authentication_error

    Когда возникает: Истёк срок действия, заданный вами при создании ключа.

    Что делать: Создайте новый ключ: срок действия продлить нельзя.

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

    permission_error

    Когда возникает: Модель существует, но требует более высокого тарифа, или у аккаунта ещё нет тарифа. В message указаны модель, нужный для неё тариф и тариф вашего ключа.

    Что делать: Вызовите GET /v1/models с тем же ключом — в списке будут только модели вашего тарифа — или повысьте тариф в разделе «Панель управления → Оплата».

  • account_suspended

    permission_error

    Когда возникает: Аккаунт заблокирован за нарушение условий использования.

    Что делать: Напишите на support@apmix.ai с адреса, привязанного к аккаунту.

  • account_on_hold

    permission_error

    Когда возникает: По аккаунту проверяется платёж; до окончания проверки запросы приостановлены.

    Что делать: С вашей стороны ничего не требуется. Следите за почтой или напишите на support@apmix.ai, если проверка займёт больше суток.

404Не найдено
  • model_not_found

    not_found_error

    Когда возникает: ID модели неизвестен, или модель больше не поддерживается.

    Что делать: Используйте ID из /v1/models или со страницы «Модели». Префиксы провайдеров вроде anthropic/ тоже принимаются.

  • not_found

    not_found_error

    Когда возникает: Такого пути или метода не существует.

    Что делать: Используйте POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, GET /v1/models или GET /v1/usage.

429Лимиты
  • allowance_exhausted

    insufficient_quota · rate_limit_error

    Когда возникает: Месячная квота взвешенных токенов исчерпана. Поле type равно insufficient_quota, как у OpenAI.

    Что делать: Повысьте тариф в разделе «Панель управления → Оплата» или дождитесь даты продления, указанной на странице «Обзор».

  • daily_limit_reached

    rate_limit_error

    Когда возникает: Вы достигли дневного лимита, который сами задали в разделе «Настройки → Лимиты».

    Что делать: Увеличьте или снимите лимит либо дождитесь полуночи по UTC.

  • weekly_limit_reached

    rate_limit_error

    Когда возникает: Вы достигли недельного лимита, который сами задали в разделе «Настройки → Лимиты».

    Что делать: Увеличьте или снимите лимит либо дождитесь понедельника, 00:00 UTC.

  • key_limit_reached

    insufficient_quota · rate_limit_error

    Когда возникает: Ключ исчерпал лимит расхода, который владелец задал ему в разделе Панель → API-ключи. type — insufficient_quota.

    Что делать: Попросите владельца ключа повысить или снять лимит расхода — ключ сразу заработает снова.

  • rate_limit_exceeded

    rate_limit_error

    Можно повторить

    Когда возникает: Больше 60 запросов за минуту с одного ключа (на Max — 120).

    Что делать: Подождите столько секунд, сколько указано в retry-after. Распределяйте тяжёлые задачи между несколькими ключами.

  • upstream_rate_limited

    rate_limit_error

    Можно повторить

    Когда возникает: Сама модель сейчас перегружена.

    Что делать: Повторите запрос, постепенно увеличивая паузу (1 с, 2 с, 4 с). Ничего не списано.

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

    api_error

    Можно повторить

    Когда возникает: Модель вернула некорректный или неожиданный ответ.

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

503Недоступно
  • upstream_unavailable

    api_error · overloaded_error

    Можно повторить

    Когда возникает: Модель не ответила вовремя или недоступна из-за технических работ.

    Что делать: Повторите запрос чуть позже или смените модель. Ничего не списано.

  • no_provider

    api_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.