air proxy — Мультипровайдерный AI шлюз

Ключевые возможности: высокая доступность и устойчивая обработка запросов, потокенный биллинг, стриминг через SSE, поддержка tools/function calling, thinking/reasoning, растущий каталог моделей. Все модели предоплатные — пополните баланс, чтобы их использовать; актуальный каталог и цены в GET /v1/models.

Base URL (OpenAI-совместимый): https://airpx.cc/v1 — Base URL (Anthropic-совместимый): https://airpx.cc

Без карты и без инвайта — начните примерно за минуту: 1. Зарегистрируйтесь на https://airpx.cc/signup (email + пароль). 2. Создайте API-ключ в панели управления на https://airpx.cc/keys (ключи начинаются с sk-proxy-*). 3. Пополните предоплатный баланс на https://airpx.cc/billing — баланс нужен до первого вызова (бесплатного тарифа нет). 4. Укажите base URL: https://airpx.cc/v1 (OpenAI) или https://airpx.cc (Anthropic) и отправьте первый запрос:

curl https://airpx.cc/v1/chat/completions \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Готово. `gpt-5.4-mini` — просто пример; полный каталог и актуальные цены в GET /v1/models. Каждый запрос списывает средства с предоплатного баланса; пополнить и проверить баланс можно на https://airpx.cc/billing.

Передайте прокси-ключ (начинается с sk-proxy-*) в любом из заголовков: • x-api-key: YOUR_KEY • Authorization: Bearer YOUR_KEY Оба заголовка взаимозаменяемы. Используйте тот, который поддерживает ваш инструмент.

Важно: прокси-ключи (sk-proxy-*) используются только для /v1/* эндпоинтов. Это НЕ токены авторизации в панели управления.

curl https://airpx.cc/v1/chat/completions \
  -H "x-api-key: sk-proxy-abc123" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4-mini", "messages": [{"role": "user", "content": "Hi"}]}'

Полный и всегда актуальный справочник API генерируется самим сервером — каждый эндпоинт, схемы запроса/ответа и параметры. Используйте интерактивный Swagger UI, чтобы изучать и пробовать запросы, или сырую OpenAPI-спецификацию для генерации клиентов. Это единственный источник истины; список ниже — лишь краткая навигация.

Какой эндпоинт использовать клиенту? Выбирайте по wire-формату — но помните: ЛЮБАЯ модель работает через ЛЮБОЙ wire, потому что шлюз мостит между ними:

• Anthropic /v1/messages — Claude Code и Anthropic SDK.
• OpenAI /v1/chat/completions — aider, Cursor, Cline, Goose и большинство OpenAI-совместимых инструментов.
• OpenAI /v1/responses — Codex CLI и другие клиенты Responses API.
• Gemini /v1beta/models/{model}:generateContent — Gemini CLI и нативные Gemini-клиенты.

Это ключевое отличие: отправляйте запрос в том wire, на котором говорит ваш клиент, и получайте доступ к любой модели каталога. Запускайте Claude или GPT внутри Gemini CLI, нативный Gemini внутри Codex или DeepSeek внутри Claude Code — thinking, tools и стриминг транслируются между форматами. Немногие шлюзы предлагают сразу все четыре протокола входа (Anthropic Messages + OpenAI chat + OpenAI Responses + нативный Gemini generateContent).

Основные эндпоинты (полные схемы запроса/ответа — в /v1/docs):

Все эндпоинты принимают JSON и возвращают JSON. Для стриминга установите "stream": true — ответ приходит через Server-Sent Events (SSE). Авторитетные параметры и схемы — в /v1/docs.

Tool / function calling работает на любой модели через любой wire. Отправляйте OpenAI-стиль `tools` на /v1/chat/completions или Anthropic `tools` с блоками tool_use / tool_result на /v1/messages — шлюз транслирует схемы инструментов и вызовы между форматами, поэтому tools работают даже когда нативный wire модели отличается от wire вашего клиента.

{
  "model": "gpt-5.5",
  "messages": [{"role": "user", "content": "Weather in Paris?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Get current weather for a city",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"]
      }
    }
  }]
}

Инструменты для кодинга (IDE / CLI) — подключите airpx как OpenAI- или Anthropic-совместимый бэкенд и укажите любой публичный id модели (например claude-opus-4-8, claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, deepseek-v4-pro). Любая модель работает в любом агенте независимо от его wire-формата — шлюз мостит между Anthropic /v1/messages (Claude Code), OpenAI /v1/chat/completions (aider, Cursor, Cline, Goose), OpenAI /v1/responses (Codex) и Gemini /v1beta generateContent (Gemini CLI). Можно запустить native Gemini или Claude внутри Codex, или GPT внутри Gemini CLI — с thinking, tools и стримингом.

export ANTHROPIC_BASE_URL=https://airpx.cc
export ANTHROPIC_AUTH_TOKEN=sk-proxy-…
export ANTHROPIC_MODEL=claude-opus-4-8
# ANTHROPIC_API_KEY тоже работает (шлюз принимает оба).

# Затем просто запустите:
claude

npm i -g @earendil-works/pi-coding-agent

API Key: sk-proxy-…
Base URL: https://airpx.cc/v1
Model: claude-opus-4-8

Base URL: https://airpx.cc/v1
API Key: sk-proxy-…
Model: claude-opus-4-8

export GOOSE_PROVIDER=openai
export GOOSE_MODEL=claude-opus-4-8
export OPENAI_HOST=https://airpx.cc
export OPENAI_BASE_PATH=v1/chat/completions
export OPENAI_API_KEY=sk-proxy-…

goose session

Base URL: https://airpx.cc/v1
API Key: sk-proxy-…
Model: claude-sonnet-4-6

export OPENAI_API_BASE=https://airpx.cc/v1
export OPENAI_API_KEY=sk-proxy-…

aider --model openai/claude-opus-4-8

npm install -g opencode-ai

model = "gpt-5.5"
model_provider = "airpx"

[model_providers.airpx]
name = "airpx"
base_url = "https://airpx.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

# Codex требует модель с Responses API (напр. gpt-5.5); wire_api должен быть "responses".

export GOOGLE_GEMINI_BASE_URL=https://airpx.cc
export GEMINI_API_KEY=sk-proxy-…

# gateway-аутентификация Gemini CLI требует external-auth (один раз):
mkdir -p ~/.gemini
echo '{"security":{"auth":{"useExternal":true}}}' > ~/.gemini/settings.json

# Любой id модели, не только Gemini ( --skip-trust для headless -p ):
gemini -m gemini-3.5-flash --skip-trust -p "Сколько 12 × 12?"
gemini -m claude-opus-4-8  --skip-trust -p "Отрефактори эту функцию"
gemini -m gpt-5.5          --skip-trust -p "Объясни async/await"

AI-агенты и чат-боты — направьте любого агента в стиле OpenClaw / Hermes на airpx через OpenAI (/v1) или Anthropic-совместимый путь.

export OPENAI_BASE_URL=https://airpx.cc/v1
export OPENAI_API_KEY=sk-proxy-…
# model: gpt-5.5 · claude-opus-4-8 · gemini-3.5-flash · deepseek-v4-pro

Каталог моделей доступен по GET /v1/models — возвращает все активные модели с ценами, возможностями и информацией о провайдере.

Все модели предоплатные — тарифицируются за 1M токенов с отдельными ценами на input, output, cache read и cache write. Актуальные цены по каждой модели в GET /v1/models (если когда-нибудь появится бесплатный тариф, такие модели покажут $0). Смотрите живой каталог и ставки в GET /v1/models, а не хардкод-список.

curl https://airpx.cc/v1/models \
  -H "x-api-key: YOUR_KEY"

airpx работает по модели предоплаты. Вы пополняете баланс в панели управления, каждый запрос списывает стоимость на основе фактического потребления токенов.

Расчёт стоимости запроса: • Input-токены × цена input (за 1M токенов) • Output-токены × цена output (за 1M токенов) • Cache read токены × цена cache read • Cache write токены × цена cache write Баланс проверяется перед каждым запросом. При недостатке средств запрос отклоняется с ошибкой "Insufficient balance" (HTTP 429) до выполнения — пополните на https://airpx.cc/billing.

Все модели предоплатные — каждый запрос списывает средства с баланса, поэтому нужно пополнить баланс до первого вызова. Пополнить можно от $1 картой, через СБП или криптовалютой, и баланс не сгорает. Пополнить и проверить баланс можно на https://airpx.cc/billing. Актуальные цены по моделям в GET /v1/models.

Установите "stream": true в теле запроса для получения инкрементальных ответов. Прокси транслирует SSE напрямую от провайдера, сохраняя оригинальный формат.

{
  "model": "gpt-5.4-mini",
  "stream": true,
  "messages": [{"role": "user", "content": "Hello!"}]
}

Thinking / reasoning также поддерживается. Используйте reasoning_effort (стиль OpenAI) или thinking: {type: "enabled", budget_tokens: N} (стиль Anthropic). Ответы включают reasoning_content или thinking-блоки соответственно.

{
  "model": "claude-opus-4-8",
  "reasoning_effort": "high",
  "stream": true,
  "messages": [{"role": "user", "content": "Solve this step by step..."}]
}

Управление reasoning: reasoning_effort в стиле OpenAI принимает low | medium | high; thinking в стиле Anthropic принимает {"type": "enabled", "budget_tokens": N}. Шлюз конвертирует между ними, поэтому reasoning-модель реагирует на любой из вариантов, который отправит клиент. По клиентам: Pi использует --thinking off|low|medium|high, OpenCode использует --variant, а Claude Code / Codex автоматически пробрасывают свои настройки thinking.

Добавьте в кабинете несколько своих ключей провайдеров — OpenAI, Anthropic, Google и других. BYOK-запросы тарифицирует ваш провайдер напрямую; airpx остаётся OpenAI/Anthropic-совместимым шлюзом перед ними.

Для B2B-команд: выдавайте сотруднику один airpx-ключ вместо набора сырых ключей провайдеров. Доступ к моделям, лимиты и расход видны отдельно по каждому ключу сотрудника. Ваши ключи провайдеров никогда не используются другими пользователями.

Тарификация: если запрос обслужен ВАШИМ СОБСТВЕННЫМ ключом провайдера, он НЕ списывается с вашего предоплаченного баланса airpx — провайдер тарифицирует вас напрямую. Запросы, обслуженные из общего пула airpx, списываются с баланса airpx как обычно.

Лимиты расхода: задайте лимит расхода (в USD) на каждый app-ключ за период — день, неделю или месяц. Управление лимитами — на странице BYOK: https://airpx.cc/byok. Лимит МЯГКИЙ: он измеряется по мере завершения каждого запроса, поэтому расход может ненадолго превысить лимит до блокировки новых запросов. BYOK-расход, учитываемый в лимите, — это ОЦЕНКА по ценам airpx; итоговый счёт вашего провайдера остаётся авторитетным.

Управление фолбэком (allow_pool_fallback, по умолчанию ВЫКЛ): при ВЫКЛ, как только лимит достигнут — или ключ провайдера отказал — новые запросы ПРИОСТАНАВЛИВАЮТСЯ до сброса периода лимита. При ВКЛ запросы уходят в общий пул airpx и списываются с баланса airpx, поэтому при балансе airpx $0 они завершатся ошибкой (пополните на https://airpx.cc/billing).

Каждый пользователь может иметь ограниченное число app-ключей (по умолчанию 5, настраивается оператором).

Видимость расхода: на странице BYOK показывается сводка бюджета по каждому ключу провайдера и раскрываемая детализация расхода по каждому app-ключу (лимит, потрачено, остаток, токены, запросы) с окном аналитики день / неделя / месяц.

Самостоятельная интроспекция: клиент может выполнить GET /v1/key (алиас /key/info) со своим app-ключом и прочитать свой несекретный статус — name, spend_cap_usd, cap_period, usage_period (потрачено за период), remaining, reset_at, provider_key (несекретная метка привязанного ключа провайдера, никогда не сырой ключ), allow_pool_fallback и allowed_models. Только чтение, вызов модели НЕ выполняется.

curl https://airpx.cc/v1/key \
  -H "Authorization: Bearer sk-proxy-YOUR_KEY"

Прокси возвращает стандартные HTTP-коды. Наиболее частые и как их решить — ниже.

Лимиты зависят от тарифа аккаунта и настроек ключа. При 429 смотрите сообщение: настоящий лимит запросов проходит после короткой паузы, а сообщение "Insufficient balance" означает, что нужно пополнить баланс в панели управления.