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

Модели

Просмотр моделей и провайдеров доступен на сайте, через API или RSS-ленту.

GET /v1/models

Возвращает список активных моделей. Без параметров — только chat/text модели. С ?filter= — фильтрация по типу.

Параметры запроса

Параметр Тип Описание
filter string Фильтр по типу: text, image, video, tts, audio, embedding, transcribe, rerank

Примеры:

# Chat/text модели (по умолчанию)
curl "https://api.ru-openrouter.ru/v1/models" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

# Image модели
curl "https://api.ru-openrouter.ru/v1/models?filter=image" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

# Embedding модели
curl "https://api.ru-openrouter.ru/v1/models?filter=embedding" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

# Video модели
curl "https://api.ru-openrouter.ru/v1/models?filter=video" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

# Audio модели
curl "https://api.ru-openrouter.ru/v1/models?filter=audio" \
  -H "Authorization: Bearer sk_ваш_api_ключ"

Схема ответа

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-4o-mini",
      "object": "model",
      "created": 1709012345,
      "owned_by": "openai",
      "model_type": "text",
      "capabilities": {
        "can_generate_image": false,
        "can_generate_audio": false,
        "can_generate_video": false,
        "can_understand_image": true,
        "can_understand_audio": false,
        "can_understand_video": false,
        "output_modalities": ["text"]
      },
      "pricing": {
        "prompt": "0.000123",
        "completion": "0.000654",
        "input_cache_read": "0.000062",
        "input_cache_write": "0.000123",
        "web_search": "0.000500",
        "image": "0.001000",
        "audio": "0.000200",
        "video": "0.000400",
        "file": "0.000300",
        "internal_reasoning": "0.000123",
        "currency": "RUB"
      },
      "context_length": 128000,
      "description": "GPT-4o mini — оптимальная модель для повседневных задач",
      "supported_parameters": ["tools", "tool_choice", "max_tokens", "temperature", "top_p", "stop", "frequency_penalty", "presence_penalty", "seed", "structured_outputs", "response_format"]
    }
  ]
}

Поля объекта модели

Поле Тип Описание
id string Идентификатор модели (например, openai/gpt-4o-mini)
object string Всегда "model"
created number Unix timestamp последнего обновления
owned_by string Владелец/провайдер (например, openai)
model_type string Тип: text, image, video, tts, audio, embedding, transcribe, rerank
capabilities object Возможности модели (подробнее ниже)
pricing object Цены в рублях (подробнее ниже)
context_length number Максимальный контекст в токенах
description string Описание модели
supported_parameters string[] Список поддерживаемых OpenAI-параметров

Capabilities

Поле Тип Описание
can_generate_image boolean Может генерировать изображения
can_generate_audio boolean Может генерировать аудио
can_generate_video boolean Может генерировать видео
can_understand_image boolean Может понимать изображения на входе
can_understand_audio boolean Может понимать аудио на входе
can_understand_video boolean Может понимать видео на входе
output_modalities string[] Форматы вывода: ["text"], ["image"], ["audio"], ["video"], ["speech"], ["transcription"], ["rerank"]

Pricing (цены в рублях)

Все цены указаны в рублях (RUB). Дополнительные поля появляются только для тех моделей, где они применяются:

Поле Тип Описание
prompt string Цена за входной токен
completion string Цена за выходной токен
input_cache_read string Цена за чтение из кэша (только для моделей с Prompt Caching)
input_cache_write string Цена за запись в кэш
web_search string Цена за веб-поиск
image string Цена за изображение на входе
audio string Цена за аудио
video string Цена за видео
file string Цена за файл
internal_reasoning string Цена за внутренние reasoning токены
currency string Всегда "RUB"

Supported Parameters

Какие OpenAI-совместимые параметры работают с моделью:

  • tools — Function calling
  • tool_choice — Выбор инструмента
  • max_tokens — Лимит выходных токенов
  • temperature — Контроль случайности
  • top_p — Nucleus sampling
  • reasoning — Режим внутренних рассуждений
  • include_reasoning — Включить reasoning в ответе
  • structured_outputs — JSON schema enforcement
  • response_format — Формат ответа
  • stop — Стоп-последовательности
  • frequency_penalty — Штраф за повторение
  • presence_penalty — Штраф за повторение темы
  • seed — Детерминированные ответы

GET /v1/models?filter=embedding

Альтернативный эндпоинт: GET /v1/embeddings/models

Для совместимости с n8n и другими клиентами, которые фильтруют модели по наличию embed в имени:

  • Если имя модели не содержит embed, к нему автоматически добавляется суффикс -embed

GET /v1/models?filter=image

Альтернативный эндпоинт: GET /v1/images/models

GET /v1/models?filter=audio

Альтернативный эндпоинт: GET /v1/audio/models

GET /v1/models?filter=tts

Альтернативный эндпоинт: GET /v1/tts/models

GET /v1/models?filter=transcribe

Альтернативный эндпоинт: GET /v1/transcriptions/models

GET /v1/models?filter=video

Альтернативный эндпоинт: GET /v1/videos/models

GET /v1/rerank/models

Список моделей для реранкинга документов.

Суффиксы моделей

К имени модели можно добавить суффикс для выбора стратегии провайдера:

Суффикс Описание
:nitro provider.sort = "throughput" — максимальная скорость
:floor provider.sort = "price" — минимальная цена

Пример:

curl https://api.ru-openrouter.ru/v1/chat/completions \
  -H "Authorization: Bearer sk_ваш_api_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o-mini:nitro",
    "messages": [{"role": "user", "content": "Быстро!"}]
  }'

Важно: токенизация

Разные модели токенизируют текст по-разному. GPT, Claude, Llama используют subword tokenizer, PaLM токенизирует по символам. Количество токенов (и, соответственно, стоимость) может отличаться для одного и того же текста на разных моделях. Для подсчёта токенов используйте поле usage в ответе.