Документация API

OpenAI-совместимый API. Замена без изменений — просто измените base URL.

Коротко

APIVAI — API-шлюз с оплатой по факту для Claude и GPT. Один API-ключ работает в двух форматах: Anthropic Messages по адресу https://api.apivai.com (Claude Code, Anthropic SDK; эндпоинт /v1/messages) и OpenAI по адресу https://api.apivai.com/v1 (эндпоинты /v1/chat/completions, /v1/responses и /v1/models). Передавайте ключ в Authorization: Bearer или x-api-key, выбирайте ID модели из GET /v1/models, а для долгих задач используйте стриминг.

ПРОКСИhttps://api.apivai.com/v1— OpenAI-совместимый API endpoint (Claude + GPT)

ANTHROPIChttps://api.apivai.com— формат Anthropic Messages (Claude Code, Anthropic SDK), без /v1

Начните за 2 минуты

APIVAI предоставляет API-прокси, совместимый с форматами Anthropic и OpenAI. Установите две переменные окружения и начинайте работу.

1. Получите API-ключ

Зарегистрируйтесь на apivai.com и пополните баланс, затем создайте API-ключ в Панели.

2. Установите Base URL

# Anthropic format (Claude Code, Anthropic SDK): https://api.apivai.com
# OpenAI format (OpenAI SDK, Cursor, Codex CLI):   https://api.apivai.com/v1

# For Anthropic SDK / Claude Code:
export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"

# For OpenAI SDK / Cursor:
export OPENAI_BASE_URL="https://api.apivai.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

3. Начните использовать

Claude Code (Mac/Linux)

ANTHROPIC_AUTH_TOKEN="YOUR_KEY" \
ANTHROPIC_BASE_URL="https://api.apivai.com" \
claude

Claude Code (Windows PowerShell)

$env:ANTHROPIC_AUTH_TOKEN="YOUR_KEY"
$env:ANTHROPIC_BASE_URL="https://api.apivai.com"
claude

Если в терминале уже задан ANTHROPIC_API_KEY, сначала удалите его, иначе он будет использован вместо ключа APIVAI: unset ANTHROPIC_API_KEY (PowerShell: Remove-Item Env:ANTHROPIC_API_KEY).

Поддерживаемые модели

claude-fable-5-1claude-fable-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-opus-5-5claude-sonnet-4-6claude-sonnet-5-5claude-sonnet-5claude-haiku-4-5claude-haiku-5-5gpt-6-astragpt-5.5gpt-5.6-solgpt-5.6-terragpt-6.1-solgpt-6-solgpt-5.6-lunagpt-6-luna

Редакторы и агенты

Эти инструменты принимают base URL и ключ в формате OpenAI. Выбирайте модель из GET /v1/models и начните с небольшой задачи — агентные инструменты расходуют много токенов.

Codex CLI

# ~/.codex/config.toml  (Windows: %USERPROFILE%\.codex\config.toml)
model = "gpt-5.5"
model_provider = "apivai"

[model_providers.apivai]
name = "APIVAI"
base_url = "https://api.apivai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

# macOS / Linux
OPENAI_API_KEY="YOUR_APIVAI_API_KEY" codex "explain what this repo does in two sentences"

# Windows PowerShell
$env:OPENAI_API_KEY="YOUR_APIVAI_API_KEY"; codex "explain what this repo does in two sentences"

Codex использует Responses API (/v1/responses), который поддерживает APIVAI, поэтому вызовы инструментов и потоковый вывод работают как положено.

Cline

Поле	Значение
API Provider	OpenAI Compatible
Base URL	https://api.apivai.com/v1
API Key	Ваш API-ключ APIVAI
Model	ID из GET /v1/models

Aider

export OPENAI_API_BASE="https://api.apivai.com/v1"
export OPENAI_API_KEY="YOUR_APIVAI_API_KEY"

# the openai/ prefix sends every model, Claude included, through APIVAI
aider --model openai/claude-sonnet-5-5

Для рутинных правок обычно хватает более дешёвой модели; на более мощную переключайтесь только для сложных изменений.

Continue.dev

Отредактируйте ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml; старый формат config.json устарел) и добавьте запись модели. С provider: openai apiBase заканчивается на /v1, и та же запись работает с ID моделей Claude и GPT. Подробно: руководство по Continue.

# ~/.continue/config.yaml
name: My Config
version: 0.0.1
schema: v1

models:
  - name: Claude Sonnet 5.5 (APIVAI)
    provider: openai
    model: claude-sonnet-5-5
    apiBase: https://api.apivai.com/v1
    apiKey: YOUR_APIVAI_API_KEY
    roles:
      - chat
      - edit
      - apply

Перед началом

В base URL /v1 встречается ровно один раз.
Выбранная модель есть в текущем списке моделей.
Процесс инструмента действительно видит ключ (переменная окружения или настройки).
Ключи не попадают в файлы проекта, общие конфиги и скриншоты.

Подробнее: API, совместимый с OpenAI · Прокси для Claude API

Вопросы и ответы

Где получить API-ключ?

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

Как выбрать модель?

Вызовите GET /v1/models с вашим ключом и используйте ID модели из ответа. Не копируйте имена моделей из старых заметок или скриншотов — набор доступных моделей меняется.

Какой base URL использовать?

Инструменты и SDK в стиле OpenAI: https://api.apivai.com/v1. Anthropic SDK и Claude Code: https://api.apivai.com (они сами добавляют /v1/messages).

Можно ли использовать Cursor или другие агенты в редакторах?

Да. Любой инструмент с поддержкой OpenAI-совместимого провайдера работает с тем же base URL, ключом и способом выбора модели.

Можно ли вызывать API прямо из кода в браузере?

Не размещайте секретные ключи в коде для браузера. Направляйте запросы через свой бэкенд и настройте там аутентификацию и ограничение частоты запросов.

Что делать, если ключ утёк?

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

Почему выходных токенов больше, чем полученного текста?

Модели размышляют перед ответом, и размышление включено по умолчанию. Токены размышления считаются выходными и оплачиваются по цене вывода. Если ответ пустой или обрезан, лимит вывода (max_tokens) израсходован на размышление — установите 4096 или больше.

Почему в примерах вместо ключа заглушка?

Заглушки не дают учётным данным попасть в систему контроля версий. Заменяйте YOUR_APIVAI_API_KEY только в локальном окружении или менеджере секретов. ID моделей в примерах (например, claude-sonnet-5-5 и gpt-5.5) настоящие; вместо них подойдёт любой ID из GET /v1/models.

Устранение неполадок

Проверяйте по порядку: конфигурацию, список моделей, затем минимальный запрос к чату. Пока эндпоинт, ключ и модель не заработают, держите запрос минимальным.

1. Проверьте список моделей

curl -i https://api.apivai.com/v1/models \
  -H "Authorization: Bearer $APIVAI_API_KEY"

Если здесь ошибка, сначала исправьте авторизацию или base URL, а потом проверяйте остальное.

2. Отправьте минимальный запрос

curl -i -X POST https://api.apivai.com/v1/chat/completions \
  -H "Authorization: Bearer $APIVAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "messages": [{"role": "user", "content": "Return one short sentence."}]
  }'

Коды ответа

Код	Частая причина	Что проверить
401	Ключ отсутствует или недействителен	Ключ задан и передаётся как Authorization: Bearer <key>.
402 insufficient_quota	У ключа закончился бюджет	Добавьте ключу бюджет в Панели или пополните баланс.
403	Аккаунт, которому принадлежит ключ, отключён	Свяжитесь с поддержкой (support@apivai.com).
404	Неверный base URL или путь	/v1 встречается ровно один раз; путь — /messages, /chat/completions, /responses или /models.
408	Тайм-аут сети или клиента	Повторите из того же терминала, затем попробуйте другую сеть.
429	Достигнут лимит запросов или закончился баланс	Снизьте параллелизм, повторяйте с задержкой, проверьте баланс.
503 / 529 overloaded_error	Модель временно перегружена	Повторите через несколько секунд, увеличивая паузу между попытками.
524	Запрос без потоковой передачи шёл дольше ~100 секунд	Для длинных ответов (большой max_tokens, долгое рассуждение) используйте "stream": true — поток не обрывается; повтор запроса без потока оплачивается снова.
5xx	Ошибка на стороне сервера	Повторите через некоторое время и запишите время запроса для поддержки.

Все коды ошибок с причинами и решениями: коды ошибок Claude API.

Почему возвращается 404 Not Found?

Неверен итоговый адрес — обычно /v1 не хватает, он лишний или повторяется. Запросы должны приходить на https://api.apivai.com/v1/messages, /v1/chat/completions, /v1/responses или /v1/models; Claude Code и Anthropic SDK используют https://api.apivai.com, инструменты в стиле OpenAI — https://api.apivai.com/v1.

Почему ключ возвращает 401?

Ключ отсутствует, введён с ошибкой, удалён или не виден процессу, который отправляет запрос. В Claude Code оставшаяся в терминале ANTHROPIC_API_KEY важнее ключа APIVAI — удалите её.

Почему возвращается 402 или 429?

402 insufficient_quota означает, что бюджет ключа исчерпан: добавьте ключу бюджет или пополните баланс. 429 — слишком много запросов сразу (по умолчанию 60 в минуту на ключ) или закончился бюджет: снизьте частоту и повторяйте с задержкой.

Почему долгий запрос падает с 524?

Запрос без стриминга, который идёт дольше ~100 секунд, обрывается по дороге. Отправляйте долгие запросы с "stream": true — потоковые ответы не обрываются.

Почему потоковый вывод ничего не показывает?

Обычно клиент не читает ответ как поток или пропускает фрагменты без текста. Проверьте:

Тело запроса содержит "stream": true.
HTTP-клиент читает тело ответа по частям.
Запрос без потоковой передачи работает — так вы отделите проблемы разбора от проблем с авторизацией или моделью.
Некоторые фрагменты содержат только метаданные или причину завершения, без текста.

Почему ответ пустой или обрезан?

Размышление включено по умолчанию, и его токены учитываются в лимите вывода. При маленьком max_tokens модель может потратить весь лимит на размышление и не вернуть текст, а запрос всё равно будет оплачен.

Причина завершения — "length" (или stop_reason равен "max_tokens"): лимит исчерпан.
Установите max_tokens 4096 или больше; для длинных ответов или кода — 8192 или больше.
Оплачиваются только фактически использованные токены, поэтому более высокий лимит сам по себе не стоит дороже.

Почему curl возвращает ошибку разбора JSON?

Кавычки в командной строке — частая причина ошибок разбора JSON. Сохраните тело запроса в файл и отправьте его через --data @body.json.

curl -i -X POST https://api.apivai.com/v1/chat/completions \
  -H "Authorization: Bearer $APIVAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data @body.json

Перед обращением в поддержку

Код ответа HTTP и путь эндпоинта (но не сам ключ).
Примерное время и часовой пояс.
Тела запроса и ответа без секретов и личных данных.
Среда выполнения и её версия, например Python или Node.js.

Документация API

Коротко

Начните за 2 минуты

1. Получите API-ключ

2. Установите Base URL

3. Начните использовать

Claude Messages API (нативный формат Anthropic)

Python (Anthropic SDK)

cURL (Messages API)

cURL (потоковый вывод)

Список моделей

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

Использование OpenAI SDK

POST /v1/chat/completions

Тело запроса

Доступные модели

Стриминг (SSE)