Как перейти с OpenRouter на APIVAI

Коротко

Переход с OpenRouter на APIVAI — это замена трёх вещей: base URL (https://api.apivai.com/v1 для клиентов формата OpenAI, https://api.apivai.com для клиентов формата Anthropic, например Claude Code), API-ключа и ID моделей (anthropic/claude-sonnet-4.6 превращается в claude-sonnet-4-6). Это имеет смысл, если основной трафик идёт на Claude или GPT: на 2026-10-10 APIVAI продаёт большинство моделей Claude на 56–62% ниже официальной цены, а GPT — до 86% ниже.

Подробное сравнение двух сервисов — на странице OpenRouter vs APIVAI.

Модель	Официальная цена (вход / выход, за 1M)	APIVAI (вход / выход, за 1M)
Claude Sonnet 4.6	$3.00 / $15.00	$1.15 / $5.74
Claude Opus 5.5	$4.00 / $20.00	$1.54 / $7.65
GPT-5.5	$5.00 / $30.00	$0.77 / $4.56

Цены APIVAI на 2026-10-10; все модели — на странице цен. OpenRouter за эти модели, как правило, берёт официальную цену провайдера; актуальные условия смотрите в ценах OpenRouter.

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

Создайте аккаунт APIVAI по email и коду подтверждения.
Пополните баланс. Минимум — $10 картой или криптовалютой либо ¥20 через Alipay / WeChat Pay.
В Dashboard создайте API-ключ. Каждому ключу можно задать свой бюджет — удобно, если для тестового переноса нужен отдельный ключ.

Как ID моделей OpenRouter соответствуют APIVAI?

OpenRouter использует ID вида провайдер/модель с точками в номере версии. APIVAI использует просто ID модели, у Claude — с дефисами. В колонке OpenRouter показан типичный шаблон; точные ID проверяйте на странице моделей OpenRouter, они могут отличаться.

ID в стиле OpenRouter	ID в APIVAI
`anthropic/claude-sonnet-4.6`	`claude-sonnet-4-6`
`anthropic/claude-opus-4.6`	`claude-opus-4-6`
`anthropic/claude-haiku-4.5`	`claude-haiku-4-5`
`anthropic/claude-opus-5.5`	`claude-opus-5-5`
`anthropic/claude-sonnet-5`	`claude-sonnet-5`
`openai/gpt-5.5`	`gpt-5.5`

ID моделей GPT в APIVAI сохраняют точки (gpt-5.5, gpt-6.1-sol); убирается только префикс openai/. Точный список для вашего ключа даёт запрос GET /v1/models (см. раздел о проверке ниже).

Шаг 1. Переменные окружения

Если код берёт base URL и ключ из окружения, для клиентов формата OpenAI это всё изменение:

# Было (OpenRouter)
export OPENAI_BASE_URL="https://openrouter.ai/api/v1"
export OPENAI_API_KEY="sk-or-..."

# Стало (APIVAI)
export OPENAI_BASE_URL="https://api.apivai.com/v1"
export OPENAI_API_KEY="ваш-ключ-apivai"

Затем обновите ID модели там, где он задан (часто это переменная MODEL или файл конфигурации).

Шаг 2. OpenAI Python SDK

from openai import OpenAI

client = OpenAI(
    base_url="https://api.apivai.com/v1",
    api_key="ваш-ключ-apivai",
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",  # было "anthropic/claude-sonnet-4.6"
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

Стриминг (stream=True), вызов инструментов и изображения на входе работают так же. Если вы передавали extra_headers или extra_body для OpenRouter, удалите их (см. ниже).

Шаг 3. OpenAI Node SDK

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.apivai.com/v1",
  apiKey: process.env.APIVAI_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-5.5", // было "openai/gpt-5.5"
  messages: [{ role: "user", content: "Hello" }],
});
console.log(resp.choices[0].message.content);

Responses API (client.responses.create) тоже работает с этим же base URL.

Шаг 4. LangChain и похожие фреймворки

Большинство фреймворков оборачивают клиент OpenAI и принимают base URL и ключ. В ChatOpenAI из LangChain это обычно выглядит так:

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",
    base_url="https://api.apivai.com/v1",
    api_key="ваш-ключ-apivai",
)

Названия параметров различаются между фреймворками и версиями (base_url, openai_api_base, baseURL), так что сверьтесь с документацией своей библиотеки. Если вы использовали отдельную интеграцию с OpenRouter, замените её на общий OpenAI-совместимый клиент фреймворка.

Шаг 5. Cursor

В Cursor откройте Settings > Models, включите Override OpenAI Base URL и укажите https://api.apivai.com/v1. Вставьте ключ APIVAI как OpenAI API key, затем добавьте нужные ID моделей (например, claude-sonnet-4-6 или gpt-5.5) как пользовательские модели. Подробности — в руководстве по настройке Cursor.

Шаг 6. Cline

В настройках Cline выберите провайдера OpenAI Compatible, укажите base URL https://api.apivai.com/v1, вставьте ключ APIVAI и введите ID модели, например claude-sonnet-4-6. Названия пунктов меню меняются от версии к версии, но важны именно эти три поля. Continue и похожие расширения настраиваются так же.

Шаг 7. Claude Code

Claude Code работает в формате Anthropic Messages, и APIVAI поддерживает этот формат нативно, так что слой трансляции не нужен. Обратите внимание: в base URL нет /v1:

export ANTHROPIC_BASE_URL="https://api.apivai.com"
export ANTHROPIC_AUTH_TOKEN="ваш-ключ-apivai"
unset ANTHROPIC_API_KEY   # если задан, он имеет приоритет и вызывает ошибки 401

Запустите claude и переключайте модели командой /model. Если раньше Claude Code шёл через OpenRouter или прокси, удалите эти настройки. Полная инструкция — в руководстве по настройке Claude Code.

Какие настройки OpenRouter нужно убрать?

Параметры маршрутизации провайдеров, например объект provider в теле запроса: APIVAI не использует эти параметры. Удалите их.
Массив models для фолбэка и похожие поля запросов OpenRouter: не поддерживаются. Передавайте одну model.
Заголовки HTTP-Referer и X-Title: они нужны для атрибуции приложений в OpenRouter. Здесь они просто не нужны, их можно удалить.
Суффиксы ID моделей и модели с авто-маршрутизацией: используйте конкретный ID модели APIVAI.

Если вы полагались на автоматический фолбэк моделей в OpenRouter, перенесите эту логику в свой код. Минимальный вариант:

for model in ["claude-sonnet-4-6", "gpt-5.5"]:
    try:
        resp = client.chat.completions.create(model=model, messages=messages)
        break
    except Exception as e:
        print(f"{model} не ответила: {e}")

Как проверить переход?

Получите список моделей, доступных вашему ключу:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer ваш-ключ-apivai"

Отправьте один запрос chat completion:

curl https://api.apivai.com/v1/chat/completions \
  -H "Authorization: Bearer ваш-ключ-apivai" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "messages": [{"role": "user", "content": "Say OK"}]}'

Затем загляните в Dashboard: каждый запрос отображается с количеством токенов и стоимостью. Частые ошибки: 401 — неверный ключ или исчерпан его бюджет (либо в Claude Code мешает ANTHROPIC_API_KEY); 404 обычно означает неверный base URL (итоговый адрес должен быть https://api.apivai.com/v1/chat/completions или https://api.apivai.com/v1/messages; большинству клиентов формата OpenAI нужен https://api.apivai.com/v1, Claude Code и Anthropic SDK — https://api.apivai.com); 429 — больше 60 запросов в минуту на один ключ.

Можно ли во время переноса работать с обоими сервисами?

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

import os
from openai import OpenAI

if os.getenv("LLM_BACKEND") == "apivai":
    client = OpenAI(base_url="https://api.apivai.com/v1", api_key=os.getenv("APIVAI_KEY"))
    model = "claude-sonnet-4-6"
else:
    client = OpenAI(base_url="https://openrouter.ai/api/v1", api_key=os.getenv("OPENROUTER_KEY"))
    model = "anthropic/claude-sonnet-4.6"

Сначала перенесите один сервис или часть трафика, несколько дней сравнивайте ответы и стоимость, затем переключите остальное. Лимит по умолчанию — 60 запросов в минуту на ключ; если для продакшен-трафика нужно больше, напишите в поддержку до переключения.

Что вы теряете, уходя с OpenRouter?

Широту выбора моделей. APIVAI предлагает только модели Claude и GPT. Если через OpenRouter вы используете открытые модели, Gemini, Mistral или другие семейства, для них по-прежнему понадобится OpenRouter или другой провайдер, и держать оба сервиса — нормальная схема. Кроме того, у APIVAI нет эндпоинтов Batch, Files, эмбеддингов, генерации изображений, аудио и fine-tuning; их предлагают официальный API OpenAI и API Anthropic.

Что для трафика Claude и GPT остаётся прежним или становится лучше: один ключ для форматов OpenAI и Anthropic, стриминг и вызов инструментов в обоих, стоимость каждого запроса в Dashboard. APIVAI не хранит и не просматривает содержимое запросов и ответов; для биллинга сохраняются только метаданные использования.

FAQ

Нужно менять код или только конфигурацию?

Обычно только конфигурацию: base URL, API-ключ и ID модели. Код придётся менять, только если вы использовали специфичные для OpenRouter поля запросов или заголовки — их нужно удалить.

Можно ли по-прежнему использовать OpenAI SDK для моделей Claude?

Да. Направьте OpenAI SDK на https://api.apivai.com/v1 и укажите ID Claude, например claude-sonnet-4-6. Можно также использовать Anthropic SDK с base URL https://api.apivai.com.

Поддерживает ли APIVAI автоматический фолбэк моделей?

Нет. Каждый запрос идёт к той модели, которую вы указали. Реализуйте фолбэк в коде: перехватывайте ошибки и повторяйте запрос с другим ID модели.

Можно ли перенести кредиты OpenRouter в APIVAI?

Нет, балансы раздельные. Израсходуйте кредиты OpenRouter или распорядитесь ими по их условиям, а APIVAI пополняйте от $10 (карта или криптовалюта) или от ¥20 (Alipay / WeChat Pay).

Как оплатить APIVAI?

Банковской картой, криптовалютой (USDT и другие), через Alipay или WeChat Pay. Оплата — предоплаченный баланс, без подписки и без ежемесячного минимума.

Где подробнее сравнить два сервиса?

Полное сравнение — на странице OpenRouter vs APIVAI, все эндпоинты — в документации.

Создать аккаунт и получить API-ключ →