Гид по OpenRouter API: один API для ИИ-моделей

Один API-ключ, один эндпоинт, сотни языковых моделей. В этом суть API OpenRouter — а поскольку он говорит на схеме OpenAI, большинству приложений достаточно поменять base URL. Этот гид проведёт вас от нуля до готовых к продакшену вызовов.

Чему вы научитесь:

• Создавать ключ и отправлять первый запрос через curl, Python и TypeScript

• Читать слаги моделей (vendor/model) и использовать варианты вроде :free, :nitro и :floor

• Работать со стримингом, лимитами запросов и фолбэками на несколько моделей

• Понимать, сколько стоит платформа — и когда мультимодальный шлюз подходит лучше

Как работает OpenRouter

Каталог моделей

OpenRouter содержит сотни моделей от OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, Qwen и других — у каждой на странице модели указаны цены за токен и характеристики контекста ^[1].

Как проходит запрос

Запрос попадает на единый эндпоинт, роутер выбирает для этой модели upstream-провайдера (у многих моделей их несколько), выполняет запрос и нормализует ответ в формат OpenAI. По умолчанию выбор провайдера балансирует цену и доступность ^[2].

Сколько это стоит

Инференс тарифицируется по прайс-листу провайдера без наценки; платформа берёт 5.5% (мин. $0.80) при покупке кредитов, а бесплатные модели ограничены 50 запросами в день (1,000 в день после покупки кредитов на $10+) ^[3].

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

1. Создайте аккаунт и ключ

Зарегистрируйтесь, купите небольшой пакет кредитов (это также поднимет лимит бесплатного уровня) и создайте ключ в дашборде. Ключи — это bearer-токены, храните их на сервере.

2. Первый запрос через curl

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "messages": [{"role": "user", "content": "Hello from the unified API"}]
  }'

3. Python и TypeScript

Официальные SDK OpenAI работают без изменений:

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-...",
)

resp = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Three taglines for a coffee app"}],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

Слаги моделей и варианты

Как читать слаг

ID моделей следуют шаблону vendor/model-name, например anthropic/claude-sonnet-4.5 или deepseek/deepseek-chat. Точная строка со страницы модели — это ровно та строка, которую ждёт API.

Варианты-суффиксы

Варианты — это подсказки маршрутизации, а не другие веса: та же модель, другой выбор провайдера ^[2].

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

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

Продакшен-вопросы

Стриминг

Установите "stream": true и читайте server-sent events — контракт идентичен стримингу OpenAI, так что существующий код стримингового UI работает без изменений.

Лимиты запросов и повторы

Лимиты растут вместе с балансом кредитов, а не по фиксированным уровням; на 429 отвечайте экспоненциальным бэкоффом. Для бесплатных моделей закладывайтесь на лимиты 50/1,000 в день ^[3].

Фолбэки

Передайте ранжированный массив models, и роутер на стороне сервера сам попробует следующую модель при ошибках или лимитах ^[4]:

{
  "model": "openai/gpt-5.2",
  "models": ["anthropic/claude-sonnet-4.5", "deepseek/deepseek-chat"],
  "messages": [{ "role": "user", "content": "..." }]
}

Когда одних языковых моделей мало

OpenRouter унифицирует текст. Как только в роадмапе появляется «сгенерировать изображение товара» или «добавить видеоклип», вы возвращаетесь к интеграциям с каждым вендором отдельно — если только ваш шлюз не покрывает эти модальности нативно.

Единый API, включающий медиамодели

APIMart применяет тот же принцип одного ключа к 500+ моделям: чат, изображения (GPT-Image-2), видео (Sora 2, Kling, Veo) и аудио (Suno).

Цены ниже прайса, а не по прайсу

Модели предлагаются примерно на 20% ниже официальных цен, а исходные и скидочные тарифы по каждой модели опубликованы на странице цен — отдельные расчёты комиссий не нужны.

Тот же код без переделок

Эндпоинты совместимы с OpenAI, так что быстрый старт выше работает с другим base URL и ключом. Ваш реестр моделей и логика фолбэков переносятся без изменений.

Итоги

Направьте OpenAI SDK на единый эндпоинт, ссылайтесь на модели по слагу vendor/model, используйте :floor или :nitro, когда важны цена или скорость, добавьте фолбэк-массив models перед продакшеном — и помните, что реальная стоимость складывается из прайса плюс комиссия 5.5% за пополнение ^[3]. Если приложению нужны ещё изображения, видео или аудио — начинайте со шлюза, который уже их покрывает.