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

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

orouter — это прокси к OpenRouter: укажите наш base URL и ключ orouter, всё остальное — как обычно. Идентификаторы моделей — родные OpenRouter (vendor/model), полный список — в каталоге.

https://orouter.dev/api/v1

Авторизация: Authorization: Bearer sk-orouter-… (или x-api-key для Anthropic SDK).

Эндпоинты

Метод	Путь	Описание
POST	`/api/v1/chat/completions`	OpenAI Chat Completions (стриминг поддерживается)	Тест
POST	`/api/v1/completions`	OpenAI Completions (legacy)	Тест
POST	`/api/v1/responses`	OpenAI Responses API	Тест
POST	`/api/v1/messages`	Anthropic Messages API	Тест
POST	`/api/v1/embeddings`	Эмбеддинги (формат OpenAI)	Тест
POST	`/api/v1/rerank`	Реранкинг документов	Тест
POST	`/api/v1/images/generations`	Генерация изображений	Тест
POST	`/api/v1/videos`	Генерация видео (асинхронный job)	Тест
GET	`/api/v1/videos/{id}`	Статус видео-задачи	Тест
GET	`/api/v1/videos/{id}/content`	Скачать готовое видео	Тест
GET	`/api/v1/models`	Каталог моделей (формат OpenRouter)	Тест
GET	`/api/v1/models/count`	Число доступных моделей	Тест
GET	`/api/v1/models/user`	Каталог для текущего ключа	Тест
GET	`/api/v1/models/{author}/{slug}`	Одна модель (поддерживает :variant)	Тест
GET	`/api/v1/models/{author}/{slug}/endpoints`	Провайдеры и цены модели	Тест
GET	`/api/v1/providers`	Список провайдеров	Тест
GET	`/api/v1/images/models`	Модели генерации изображений	Тест
GET	`/api/v1/images/models/{author}/{slug}/endpoints`	Провайдеры image-модели	Тест
GET	`/api/v1/videos/models`	Модели генерации видео	Тест
GET	`/api/v1/embeddings/models`	Модели эмбеддингов	Тест
GET	`/api/v1/generation?id={id}`	Статистика генерации (токены, стоимость)	Тест
GET	`/api/v1/credits`	Куплено/потрачено кредитов (формат OpenRouter)	Тест
GET	`/api/v1/key`	Информация о текущем ключе (формат OpenRouter)	Тест

Биллинг

Списание — ровно та сумма, которую OpenRouter насчитал за запрос (поле usage.cost присутствует в каждом ответе). Для запроса нужен положительный баланс; неуспешные запросы (ошибки провайдера) не тарифицируются. Все параметры OpenRouter — provider-роутинг, :free/:nitro-варианты, reasoning — проходят насквозь.

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(base_url="https://orouter.dev/api/v1", api_key="sk-orouter-...")

r = client.chat.completions.create(
    model="anthropic/claude-sonnet-4.6",
    messages=[{"role": "user", "content": "Привет!"}],
    stream=True,
)
for chunk in r:
    print(chunk.choices[0].delta.content or "", end="")

Python (Anthropic SDK)

from anthropic import Anthropic

client = Anthropic(base_url="https://orouter.dev/api", api_key="sk-orouter-...")

msg = client.messages.create(
    model="anthropic/claude-sonnet-4.6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Привет!"}],
)
print(msg.content[0].text)

curl

curl https://orouter.dev/api/v1/chat/completions \
  -H "Authorization: Bearer sk-orouter-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini",
    "messages": [{"role": "user", "content": "Привет!"}]
  }'