Получение списка моделей

Как получить и фильтровать список доступных AI моделей через API

Получение списка моделей

Актуальный список всех моделей с ценами и возможностями доступен на главной странице usellm.ru в разделе «Модели и цены».

В этом гайде вы узнаете, как получить список моделей программно через API, фильтровать их по типу и получать детальную информацию о ценах и возможностях.

Endpoint

GET https://api.usellm.ru/v1/models

Возвращает список всех доступных AI моделей с информацией о типе, возможностях и ценах.

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

ПараметрТипОбязательныйОписание
typestringНетФильтр по типу модели
include_providersbooleanНетВключить детальную информацию о провайдерах

Значения параметра type

ЗначениеОписание
chatТекстовые модели для чата (GPT, Claude, Gemini и др.)
imageМодели генерации изображений
embeddingМодели для создания эмбеддингов
audioМодели для работы с аудио
videoМодели генерации видео
ttsМодели синтеза речи (Text-to-Speech)
sttМодели распознавания речи (Speech-to-Text)

Примеры запросов

# Все модели
curl "https://api.usellm.ru/v1/models" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

# Только чат-модели
curl "https://api.usellm.ru/v1/models?type=chat" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

# С информацией о провайдерах
curl "https://api.usellm.ru/v1/models?type=chat&include_providers=true" \
  -H "Authorization: Bearer <USELLM_API_KEY>"

Структура ответа

{
  "data": [
    {
      "id": "openai/gpt-6-astra",
      "name": "GPT-6 Astra",
      "type": "chat",
      "short_description": "Флагманская мультимодальная модель OpenAI",
      "created": 1715367049,
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"],
        "tokenizer": "o200k_base"
      },
      "top_provider": {
        "is_moderated": true,
        "context_length": 128000,
        "max_completion_tokens": 16384,
        "pricing": {
          "prompt_per_million": "141.00",
          "completion_per_million": "2830.72",
          "currency": "RUB"
        },
        "supported_parameters": ["temperature", "top_p", "frequency_penalty", "presence_penalty", "tools", "tool_choice", "response_format"],
        "default_parameters": {
          "temperature": 1.0,
          "top_p": 1.0,
          "frequency_penalty": 0
        }
      },
      "endpoints": ["/v1/chat/completions"]
    }
  ]
}

Описание полей

ПолеТипОписание
idstringИдентификатор модели для использования в API запросах
namestringЧеловекочитаемое название модели
typestringТип модели: chat, image, embedding, audio, video, tts, stt
short_descriptionstring?Краткое описание модели
creatednumberUnix timestamp создания модели
architectureobjectИнформация об архитектуре модели
top_providerobjectИнформация о лучшем доступном провайдере
endpointsarrayСписок endpoint'ов, поддерживающих эту модель

Поля architecture

ПолеОписание
modalityСтрока вида input->output (например text+image->text)
input_modalitiesМассив поддерживаемых входных модальностей
output_modalitiesМассив поддерживаемых выходных модальностей
tokenizerИспользуемый токенизатор

Поля top_provider

ПолеОписание
is_moderatedМодерируется ли контент провайдером
context_lengthМаксимальный размер контекста в токенах
max_completion_tokensМаксимальное количество токенов в ответе
pricingЦены (см. ниже)
supported_parametersСписок поддерживаемых параметров запроса
default_parametersЗначения параметров по умолчанию

Поля pricing

ПолеОписание
prompt_per_millionЦена за промпт (RUB за 1М токенов)
completion_per_millionЦена за completion (RUB за 1М токенов)
image_input_per_millionЦена за входные изображения (RUB за 1М токенов)
audio_per_millionЦена за аудио (RUB за 1М токенов)
per_requestЦена за запрос (RUB)
stt_per_minuteЦена за минуту распознавания речи (RUB)
tts_per_million_charactersЦена за 1М символов синтеза речи (RUB)
video_per_secondЦена за секунду видео (RUB)
input_cache_read_per_millionЦена за чтение из кэша (RUB за 1М токенов)
input_cache_write_per_millionЦена за запись в кэш (RUB за 1М токенов)
currencyВалюта (всегда RUB)

Использование ID модели

ID модели из ответа используется в параметре model при отправке запросов:

const completion = await openai.chat.completions.create({
  model: 'openai/gpt-6-astra',  // ID модели из /v1/models
  messages: [...]
});

Следующие шаги