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

​
Endpoint

GET https://polza.ai/api/v1/models
Возвращает список всех доступных AI моделей с информацией о типе, возможностях и ценах.

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

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

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

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

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

// Все модели
const response = await fetch('https://polza.ai/api/v1/models', {
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>'
  }
});
const data = await response.json();
console.log(`Найдено ${data.data.length} моделей`);

// Только чат-модели
const chatModels = await fetch('https://polza.ai/api/v1/models?type=chat', {
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>'
  }
});

// С информацией о провайдерах
const detailed = await fetch('https://polza.ai/api/v1/models?type=chat&include_providers=true', {
  headers: {
    'Authorization': 'Bearer <POLZA_AI_API_KEY>'
  }
});

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

{
  "data": [
    {
      "id": "openai/gpt-4o",
      "name": "GPT-4o",
      "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": "7.50",
          "completion_per_million": "22.50",
          "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": ["/api/v1/chat/completions"]
    }
  ]
}

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

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

​
Поля 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)
internal_reasoning_per_millionЦена за reasoning токены (RUB за 1М)
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-4o',  // ID модели из /models
  messages: [...]
});

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

Текстовые запросы

Научитесь отправлять запросы к текстовым моделям