← AirPXEN

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

330+ моделей · 30 провайдеров · Совместимость с OpenAI и Anthropic

Единая точка доступа к AI-моделям от множества провайдеров. Полная совместимость с OpenAI и Anthropic SDK — работает с Claude Code, Cursor, Aider, Codex CLI, Pi Coding Agent и другими инструментами.

Обзор

airpx — мультипровайдерный AI-шлюз, предоставляющий доступ к 330+ моделям от 30 провайдеров через единый API. Полностью совместим с OpenAI и Anthropic API.

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

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

Быстрый старт

Начните работу за три шага.

1. Зарегистрируйтесь на https://airpx.cc и создайте API-ключ в панели управления. 2. Укажите base URL: https://airpx.cc/v1 (OpenAI) или https://airpx.cc (Anthropic). 3. Отправьте первый запрос:

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

Готово! Многие модели, включая grok-4-reason, бесплатны — можно начать сразу после регистрации.

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

Все /v1/* эндпоинты принимают ваш API-ключ через один из двух заголовков.

Передайте прокси-ключ (начинается с 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": "grok-4-reason", "messages": [{"role": "user", "content": "Hi"}]}'

Справочник API

Публичные прокси-эндпоинты. Все требуют валидный API-ключ.

POST/v1/chat/completionsChat completion (формат OpenAI). Стриминг поддерживается.
POST/v1/messagesAnthropic Messages API (нативный формат). Стриминг поддерживается.
POST/v1/responsesOpenAI Responses API (Codex CLI). Стриминг поддерживается.
GET/v1/modelsКаталог моделей с ценами и возможностями.
POST/v1/embeddingsГенерация эмбеддингов (формат OpenAI).
POST/v1/audio/transcriptionsТранскрипция аудио (Whisper-совместимый).

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

Интеграции

airpx работает как прозрачный бэкенд для популярных AI-инструментов и IDE.

🔧Claude Code

  1. Добавьте переменные окружения в ~/.bashrc или ~/.zshrc
  2. Запустите claude как обычно
bash
export ANTHROPIC_BASE_URL=https://airpx.cc
export ANTHROPIC_API_KEY=YOUR_KEY

# Then just run:
claude

🔧Pi Coding Agent

  1. Установите переменные окружения Anthropic
  2. Запустите pi — используется /v1/messages со стримингом SSE
bash
export ANTHROPIC_BASE_URL=https://airpx.cc
export ANTHROPIC_API_KEY=YOUR_KEY

# Or in .env / config:
ANTHROPIC_BASE_URL=https://airpx.cc
ANTHROPIC_API_KEY=YOUR_KEY

🔧Cursor

  1. Откройте Settings → Models → OpenAI API Key + Base URL
  2. Введите ваш airpx ключ и base URL
text
API Key: YOUR_KEY
Base URL: https://airpx.cc/v1

🔧Cline (VS Code)

  1. Откройте настройки расширения → API Provider → OpenAI Compatible
  2. Введите ваш airpx ключ и base URL
text
Base URL: https://airpx.cc/v1
API Key: YOUR_KEY
Model: claude-opus-4

🔧Aider

  1. Установите переменную OPENAI_BASE_URL
  2. Запустите aider с любой поддерживаемой моделью
bash
export OPENAI_BASE_URL=https://airpx.cc/v1
export OPENAI_API_KEY=YOUR_KEY

aider --model claude-opus-4

🔧OpenCode

  1. Установите переменную OPENAI_BASE_URL
  2. Запустите opencode
bash
export OPENAI_BASE_URL=https://airpx.cc/v1
export OPENAI_API_KEY=YOUR_KEY

opencode

🔧Codex CLI

  1. Установите openai_base_url в ~/.codex/config.toml
  2. Экспортируйте OPENAI_API_KEY и запустите codex
openai_base_url = "https://airpx.cc/v1"

SDK

Используйте стандартные OpenAI и Anthropic SDK — просто укажите airpx как базовый URL.

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://airpx.cc/v1",
    api_key="YOUR_KEY"
)

r = client.chat.completions.create(
    model="grok-4-reason",  # free
    messages=[{"role": "user", "content": "Hello!"}]
)
print(r.choices[0].message.content)

Модели

airpx предоставляет доступ к 330+ моделям от 30 провайдеров. Полный каталог доступен по /v1/models.

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

Модели делятся на бесплатные и платные. Многие модели доступны бесплатно — смотрите GET /v1/models (бесплатные показывают $0). Платные тарифицируются за 1M токенов с отдельными ценами на input, output, cache read и cache write. Примеры цен: grok-4-fast $0.20/$0.50, gpt-5.5 $5/$30, claude-opus-4 $5/$25 за 1M токенов (input/output).

List 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 Баланс проверяется перед каждым запросом. При недостатке средств возвращается HTTP 402 (Payment Required).

Бесплатные модели не списывают средства с баланса и доступны сразу после регистрации. Актуальный список смотрите на странице Модели или через GET /v1/models.

Стриминг

Оба формата (OpenAI и Anthropic) поддерживают стриминг через Server-Sent Events (SSE).

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

{
  "model": "grok-4-reason",
  "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",
  "reasoning_effort": "high",
  "stream": true,
  "messages": [{"role": "user", "content": "Solve this step by step..."}]
}

Свой ключ (BYOK)

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

Если у вас есть собственный API-ключ провайдера (OpenAI, Anthropic, Google и др.), вы можете добавить его в панели управления. Запросы через ваш ключ тарифицируются провайдером напрямую — airpx работает как прозрачный прокси.

BYOK полезен при необходимости более высоких лимитов, доступа к определённым моделям или использования существующего тарифа провайдера. Ваши ключи никогда не используются другими пользователями.

Лимиты и ошибки

HTTP-коды ответов и типичные сценарии ошибок.

Прокси возвращает стандартные HTTP-коды: • 401 Unauthorized — невалидный или отсутствующий API-ключ • 402 Payment Required — недостаточный баланс для запрошенной модели • 403 Forbidden — модель недоступна для вашего ключа или тарифа • 429 Too Many Requests — превышен лимит запросов, повторите позже • 500 Internal Server Error — внутренняя ошибка прокси • 502 Bad Gateway — ошибка или таймаут провайдера

Лимиты зависят от тарифа аккаунта и настроек ключа. При 429 подождите несколько секунд и повторите запрос. Ошибки баланса (402) требуют пополнения в панели управления.

FAQ

airpx совместим с OpenAI?▼
Да. airpx — полная замена OpenAI API. Укажите любому OpenAI SDK или инструменту адрес https://airpx.cc/v1 и всё заработает без изменений.
Поддерживается ли Anthropic Messages API?▼
Да. airpx нативно поддерживает формат Anthropic Messages на POST /v1/messages. Укажите Anthropic base URL: https://airpx.cc и используйте свой airpx-ключ.
Какой заголовок авторизации использовать?▼
Можно использовать x-api-key: YOUR_KEY или Authorization: Bearer YOUR_KEY. Оба работают одинаково для всех /v1/* эндпоинтов.
Где получить API-ключ?▼
Зарегистрируйтесь на https://airpx.cc, затем создайте прокси-ключ в панели управления. Ключи начинаются с sk-proxy-*.
Какие модели бесплатны?▼
Многие модели доступны бесплатно. Список меняется по мере обновления провайдеров — смотрите GET /v1/models. Бесплатные модели показывают $0.
Работает ли стриминг?▼
Да. Установите "stream": true в теле запроса. Оба формата (OpenAI и Anthropic) используют Server-Sent Events (SSE).
Работает ли tools / function calling?▼
Да. Tools и function calling полностью поддерживаются для обоих форматов (OpenAI и Anthropic). Передавайте определения инструментов как обычно.
Можно ли использовать свой ключ провайдера (BYOK)?▼
Да. Вы можете добавить свои ключи OpenAI, Anthropic или другого провайдера в панели управления. Запросы через ваш ключ тарифицируются провайдером напрямую.
Есть ли Swagger / OpenAPI спецификация?▼
Да. Откройте /v1/docs для интерактивного Swagger UI с полной OpenAPI-спецификацией.
Как связаться с поддержкой?▼
Откройте issue в нашем репозитории или напишите через форму в панели управления.