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

DeepSeek Harness с apmix

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

Базовые 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
gemini-3.8-flash
  1. Запустите DeepSeek Harness

    Нужен Node.js 22.19 или новее. Веб-интерфейс откроется по адресу http://127.0.0.1:3080.

    Терминал
    npx @deepseek-ai/dsh web
  2. Добавьте apmix в разделе «Settings → Models»

    Выберите «Add a custom provider» и введите эти значения. Протокол — OpenAI Chat Completions.

    Значения
    Provider ID   apmix
    Base URL      https://api.apmix.ai/v1
    Protocol      OpenAI Chat Completions
    API key       apx_live_YOUR_KEY
    Model         gemini-3.8-flash

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

  3. Или настройте через YAML

    Тот же провайдер в виде блока в ~/.dsh/settings.yaml; ключ берётся из переменной окружения APMIX_API_KEY.

    mkdir -p ~/.dsh
    [ -f ~/.dsh/settings.yaml ] && cp ~/.dsh/settings.yaml ~/.dsh/settings.yaml.bak
    cat > ~/.dsh/settings.yaml <<'EOF'
    llm-pi-ai:
      providers:
        apmix:
          apiKeyEnv: APMIX_API_KEY
          api: openai-completions
          baseURL: https://api.apmix.ai/v1
          models:
            - id: gemini-3.8-flash
    EOF
    echo 'export APMIX_API_KEY="apx_live_YOUR_KEY"' >> ~/.zshrc   # or ~/.bashrc
    export APMIX_API_KEY="apx_live_YOUR_KEY"

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

Проверка

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

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