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

GET /api/v1/models возвращает каталог доступных моделей и их свойства. Здесь можно посмотреть список моделей, сравнить возможности и выбрать подходящий вариант для поля model.

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

Каталог моделей поддерживает параметры запроса для фильтрации списка.

`output_modalities`

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

Значение	Что означает
`text`	Модели, которые возвращают текст
`image`	Модели, которые создают изображения
`audio`	Модели, которые возвращают звук
`embeddings`	Модели эмбеддингов
`all`	Все модели без фильтрации по типу результата

Примеры:

# По умолчанию — текстовые модели
curl "https://api.alltokens.ru/api/v1/models"

# Только модели для изображений
curl "https://api.alltokens.ru/api/v1/models?output_modalities=image"

# Текстовые и графические модели
curl "https://api.alltokens.ru/api/v1/models?output_modalities=text,image"

# Все модели без фильтрации
curl "https://api.alltokens.ru/api/v1/models?output_modalities=all"

`supported_parameters`

Фильтр по параметрам API, которые понимает модель. Например, так можно найти модели с поддержкой tools:

curl "https://api.alltokens.ru/api/v1/models?supported_parameters=tools"

Стандарт каталога моделей

Справочник моделей AllTokens отдаёт самые важные сведения о каждой доступной модели в едином формате. Это позволяет не разбирать ответ отдельно под каждого поставщика и использовать один и тот же формат в рабочем коде.

Схема ответа API

GET /api/v1/models возвращает JSON-объект со списком моделей в поле data.

Корневой объект ответа

{
  "data": [
    /* Массив объектов модели */
  ]
}

Объект модели

Каждый элемент массива data содержит стандартизированные поля:

Поле	Тип	Что означает
`id`	`string`	Уникальный идентификатор модели для запросов API, например `"openai/gpt-4.1-mini"`
`canonical_slug`	`string`	Постоянный символьный идентификатор модели
`name`	`string`	Человекочитаемое название модели
`created`	`number`	Время добавления модели в каталог в формате Unix-времени
`description`	`string`	Подробное описание возможностей модели
`context_length`	`number`	Максимальный размер контекстного окна в токенах
`architecture`	`object`	Технические возможности модели
`pricing`	`object`	Структура стоимости для этой модели
`top_provider`	`object`	Основные сведения о базовом поставщике
`per_request_limits`	`object \| null`	Ограничения на один запрос, если они есть
`supported_parameters`	`string[]`	Список поддерживаемых параметров API
`default_parameters`	`object \| null`	Значения параметров по умолчанию, если они заданы
`expiration_date`	`string \| null`	Дата вывода из эксплуатации, если модель помечена к отключению

Объект `architecture`

{
  "input_modalities": string[],   // Поддерживаемые типы входа: ["file", "image", "text"]
  "output_modalities": string[],  // Поддерживаемые типы результата: ["text"]
  "tokenizer": string,            // Способ разбиения текста на токены
  "instruct_type": string | null  // Формат инструкций, если применимо
}

Объект `pricing`

Все значения стоимости передаются строками.

{
  "prompt": string,             // Стоимость входных токенов
  "completion": string,         // Стоимость выходных токенов
  "request": string,            // Фиксированная стоимость запроса
  "image": string,              // Стоимость входного изображения
  "web_search": string,         // Стоимость веб-поиска
  "internal_reasoning": string, // Стоимость внутренних токенов рассуждения
  "input_cache_read": string,   // Стоимость чтения из входного кэша
  "input_cache_write": string   // Стоимость записи во входной кэш
}

Объект `top_provider`

{
  "context_length": number,        // Ограничение контекста у основного поставщика
  "max_completion_tokens": number, // Максимальный размер ответа
  "is_moderated": boolean          // Применяется ли модерация содержимого
}

Поддерживаемые параметры

Поле supported_parameters показывает, какие OpenAI-совместимые параметры реально работают у конкретной модели:

tools — вызов инструментов
tool_choice — управление выбором инструмента
max_tokens — ограничение длины ответа
temperature — управление вариативностью
top_p — ядерная выборка
reasoning — внутренний режим рассуждения
include_reasoning — возврат рассуждений в ответе
structured_outputs — строгий вывод по схеме JSON
response_format — формат результата
stop — пользовательские стоп-последовательности
frequency_penalty — снижение повторов
presence_penalty — повышение тематического разнообразия
seed — воспроизводимый результат

Разные модели по-разному считают токены

Разные модели используют разные токенизаторы. Поэтому даже при одинаковом входе и одинаковом ответе число токенов может отличаться. Фактические значения смотрите в usage у конкретного ответа.

Как использовать каталог на практике

Сначала отфильтруйте модели по типу результата

Если вам нужен текст, изображения, звук или эмбеддинги, начните с output_modalities.

Потом проверьте поддерживаемые параметры

Если вам нужны tools, response_format, reasoning или другие функции, смотрите supported_parameters.

После этого сравните контекст и свойства

Проверьте context_length, architecture, pricing и top_provider, чтобы выбрать рабочий вариант под вашу задачу.