Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://speshu.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Актуальный перечень моделей с ценами можно посмотреть на speshu.ai.
В этом разделе вы узнаете, как через API получить список доступных моделей в SpeShu.AI, отфильтровать их и посмотреть подробности — тип, параметры и стоимость.
Дополнительно описание endpoint доступно в разделе API Reference.

​
Endpoint

GET https://speshu.ai/api/v1/models
Запрос возвращает все доступные модели с базовой информацией: тип, возможности и цены.

​
Параметры

При необходимости результат можно отфильтровать: type — ограничивает список по типу модели include_providers — добавляет данные о провайдерах

​
Типы моделей (type)

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

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

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

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

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

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

{
  "data": [
    {
      "id": "openai/gpt-5.5",
      "name": "GPT-5.4",
      "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"]
    }
  ]
}

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

ПолеОписание
idиспользуется в запросах к API
nameотображаемое название
typeкатегория модели
short_descriptionкраткое описание
createdдата создания (timestamp)
architectureвходы, выходы и токенизатор
top_providerпараметры и цены у провайдера
endpointsдоступные endpoint’ы
parametersдополнительные настройки (если есть)
operationsподдерживаемые операции

​
Блок architecture

ПолеОписание
modalityформат входа и выхода
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цена за выходные токены (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 из ответа передаётся в параметр model при вызове API: 
const completion = await openai.chat.completions.create({
  model: 'openai/gpt-5.5',  // ID модели из /models
  messages: [...]
});