Модели и цены

Как выбрать модель под задачу: где взять актуальный список, как по нему фильтровать и на что смотреть. Формат полей и параметры запроса разобраны в Каталоге моделей и Каталоге медиа-моделей.

Каталог — источник истины

Единственный правильный способ узнать, какие модели доступны, — запросить каталог:

cURL

curl https://speshu.ai/api/v1/models

Не зашивайте список моделей в код. Состав каталога меняется: модели появляются, уходят и отключаются, а идентификаторы переименовываются. Список, зашитый в код, устареет молча — запросы начнут падать с 404 model_not_found. Берите идентификаторы из ответа каталога каждый раз.

Идентификаторы

Значение поля id из ответа передаётся в запрос как есть, в поле model. Не добавляйте префикс и не убирайте его — берите ровно то, что вернул каталог, вместе с регистром и со слэшем в именах вида группа/имя. Если идентификатор неизвестен API, приходит 404 с кодом model_not_found. Идентификаторы со временем меняются, поэтому разрешайте их динамически, а не константой в конфиге. Полный формат ответа — в разделе Каталог моделей.

Состав каталога

В GET /api/v1/models попадают только включённые платные текстовые модели. Отключённые и бесплатные модели не помечаются флагом, а отсутствуют в выдаче целиком — отсутствие модели в каталоге само по себе ничего не значит, кроме того, что её сейчас нельзя вызвать. Модели генерации изображений, видео, аудио и музыки в этом эндпоинте не живут. За ними идите в GET /api/v1/media/models.

Ответ

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "openai",
      "title": "GPT-4o",
      "context_length": 128000,
      "cost_context": "150.00",
      "cost_completion": "600.00",
      "currency": "RUB"
    }
  ]
}

Поле	Что это
`id`	То, что вы отправляете в поле `model`
`title`	Название для показа человеку
`owned_by`	Провайдер модели
`context_length`	Размер контекстного окна в токенах
`cost_context`	Цена за миллион входных токенов, десятичной строкой
`cost_completion`	Цена за миллион выходных токенов, десятичной строкой
`currency`	Валюта цен, обычно `RUB`
`created`	Unix-время в секундах: когда модель появилась в каталоге

context_length — не справочное значение. API сверяет с ним длину запроса до отправки: если входные токены плюс зарезервированный выход в окно не помещаются, приходит 422 content_too_large.

Аутентификация здесь необязательна

Каталог открыт без ключа: без него вернутся базовые цены, с ключом — цены вашего аккаунта. Использовать эндпоинт из публичного фронтенда безопасно.

cURL

# базовые цены
curl https://speshu.ai/api/v1/models

# цены вашего аккаунта
curl https://speshu.ai/api/v1/models \
  -H "Authorization: Bearer $SPESHU_API_KEY"

Как получить ключ — на странице Аутентификация.

Медиа-модели

Каталог генерации медиа живёт отдельно:

cURL

curl https://speshu.ai/api/v1/media/models

Он тоже не требует ключа. Для каждой модели отдаёт media_type (image, video или audio), полную input_schema — авторитетное описание принимаемых параметров, соответствующее запущенной версии API — и поле pricing с ценами.

Читайте параметры и цены любой медиа-модели из этого ответа, а не из таблиц документации: input_schema всегда соответствует текущей версии API, а документация обновляется не одновременно с ним.

Изображения

Генерация, редактирование, апскейл

Видео

Генерация видео и работа с кадром

Аудио и музыка

Речь, звуки и музыка

Фильтрация каталога

Самая дешёвая модель со зрением

Зрение — это возможность принять блок image_url в запросе. Сами по себе каталог и фильтр по нему её не проверяют: попытка отправить изображение модели без зрения вернёт 400 invalid_request. Отбор по названию или известности модели — эвристика, а не проверка.

cURL

curl -s https://speshu.ai/api/v1/models \
  | jq '[.data[]
      | select((.title | ascii_downcase) | test("vision|4o|sonnet|gemini"))
      | {id, cost_completion}] \
    | sort_by(.cost_completion | tonumber) \
    | .[0]'

Модель с наибольшим контекстным окном

cURL

curl -s https://speshu.ai/api/v1/models \
  | jq '[.data[]] | sort_by(.context_length) | reverse | .[0] \
    | {id, context_length}'

Самая дешёвая модель для изображений

cURL

curl -s https://speshu.ai/api/v1/media/models \
  | jq '[.data[]
      | select(.media_type == "image" and .pricing.type == "fixed")
      | {id, title, price: .pricing.tiers[0].price}]
    | sort_by(.price | tonumber) | .[0]'

Фильтр берёт модели с фиксированной ценой: у моделей, тарифицируемых по параметрам и по единице, структура в tiers другая, и сравнивать их по tiers[0].price нельзя. Полную картину по всем трём типам смотрите в pricing — разбор в каталоге медиа-моделей.

То же самое на Python:

Python

import requests
from decimal import Decimal

BASE = "https://speshu.ai/api/v1"

# модель с наибольшим контекстным окном
models = requests.get(f"{BASE}/models", timeout=30).json()["data"]
widest = max(models, key=lambda m: m["context_length"])
print(widest["id"], widest["context_length"])

# самая дешёвая модель для изображений
media = requests.get(f"{BASE}/media/models", timeout=30).json()["data"]
images = [
    m for m in media
    if m["media_type"] == "image" and m["pricing"]["type"] == "fixed"
]
cheapest = min(images, key=lambda m: Decimal(m["pricing"]["tiers"][0]["price"]))
print(cheapest["id"], cheapest["pricing"]["tiers"][0]["price"], "₽")

Как выбирать

Ориентируйтесь на четыре критерия, проверяя их в таком порядке. Контекстное окно против самого длинного входа. Возьмите самый большой реальный запрос из вашей нагрузки — длинный документ, большой диалог, объединённый контекст — и сравните его длину в токенах с context_length. Модели, у которых окно меньше, отпадают сразу, до разбора остальных критериев. Зрение, если вы отправляете изображения. Модель без него отвергнет запрос с 400 invalid_request целиком, а не проигнорирует картинку. Возможности: инструменты, структурированный вывод, рассуждение. Все три включаются параметрами запроса, и поддержка у модели неодинаковая. Проверяйте на ваших данных: неверно разобранный по схеме JSON и потерянный вызов инструмента обходятся дороже, чем лишний токен. Цена за миллион токенов. Сравнивайте по той валюте, в которой реально платите, и по обеим сторонам: cost_context и cost_completion. Для рассуждающих моделей смотрите на выходные токены — они там дороже всего и растут вместе с effort. Подробности — в гайде по токенам рассуждений.

Бенчмарк одной модели не переносится на вашу нагрузку: она состоит из ваших промптов, вашего формата данных и вашего критерия «хорошо». Прогоните две-три кандидатуры на представительной выборке своих запросов и сравните качество вместе со счётом — расхождение между ними обычно больше, чем разница цен.

Что дальше

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

Формат ответа и цены за миллион токенов

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

Схемы параметров и тарифы генерации

Запрос чату

Отправить выбранную модель в чат

Тарификация и оплата

Как считается стоимость и списываются деньги

Начало

Работа с API

О сервисе

Каталог — источник истины

Идентификаторы

Состав каталога

Ответ

Аутентификация здесь необязательна

Медиа-модели

Изображения

Видео

Аудио и музыка

Фильтрация каталога

Самая дешёвая модель со зрением

Модель с наибольшим контекстным окном

Самая дешёвая модель для изображений

Как выбирать

Что дальше

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

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

Запрос чату

Тарификация и оплата

​Каталог — источник истины

​Идентификаторы

​Состав каталога

​Ответ

​Аутентификация здесь необязательна

​Медиа-модели

Изображения

Видео

Аудио и музыка

​Фильтрация каталога

​Самая дешёвая модель со зрением

​Модель с наибольшим контекстным окном

​Самая дешёвая модель для изображений

​Как выбирать

​Что дальше

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

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

Запрос чату

Тарификация и оплата

Каталог — источник истины

Идентификаторы

Состав каталога

Ответ

Аутентификация здесь необязательна

Медиа-модели

Фильтрация каталога

Самая дешёвая модель со зрением

Модель с наибольшим контекстным окном

Самая дешёвая модель для изображений

Как выбирать

Что дальше