Модели и идентификаторы

Идентификатор модели — единственное, что связывает ваш код с конкретной нейросетью. Он один и тот же во всех методах и не зависит от того, какая площадка обслужит запрос.

Формат

Идентификатор состоит из автора модели и её имени через косую черту: anthropic/claude-sonnet-5, openai/gpt-5-mini, deepseek/deepseek-v3. Автор — тот, кто модель обучил, а не тот, кто её хостит. Хостинг — это площадка, и она выбирается маршрутизацией, а не идентификатором.

Почему это важно

Одна и та же deepseek/deepseek-v3 может физически исполняться у трёх разных площадок с разной ценой и задержкой. Для вашего кода это одна модель — счёт и ответ вы получаете в одном формате независимо от того, кто её сегодня отдал.

Каталог через API

bash

curl https://zerno.one/api/v1/models \
  -H "Authorization: Bearer $ZERNO_API_KEY"

json

{
  "data": [
    {
      "id": "anthropic/claude-sonnet-5",
      "name": "Claude Sonnet 5",
      "author": "anthropic",
      "context_length": 200000,
      "max_completion_tokens": 64000,
      "modalities": {"input": ["text", "image", "pdf"], "output": ["text"]},
      "capabilities": ["tools", "json_schema", "reasoning", "prompt_cache"],
      "pricing": {
        "currency": "RUB",
        "prompt": 264.0,          // ₽ за 1 млн входных токенов
        "completion": 1320.0,     // ₽ за 1 млн выходных
        "cache_read": 26.4,
        "image": 0.42             // ₽ за изображение
      },
      "providers": ["anthropic", "bedrock"],
      "status": "active"
    }
  ]
}

Цены отдаются в рублях и уже включают нашу наценку — это итоговая сумма, которая спишется с баланса. Методика и сравнение с первоисточником — на странице сравнения цен.

Поля, на которые стоит смотреть

Поле	Что означает
context_length	Сколько токенов помещается во вход и выход вместе. Превышение — 400, а не обрезка.
max_completion_tokens	Потолок одного ответа. Часто заметно меньше контекста.
modalities.input	Что модель принимает: text, image, pdf, audio. Отправка неподдерживаемого типа — 400.
capabilities	tools, json_schema, reasoning, prompt_cache. Проверяйте до вызова, а не по факту ошибки.
providers	Площадки, на которых модель доступна. Одна площадка — резервировать некуда.
status	active, deprecated или retired. См. ниже.

Жизненный цикл

active — обычное состояние.
deprecated — автор объявил дату отключения. Модель работает, но в ответе появляется заголовок X-Model-Deprecated с датой. Это сигнал заводить задачу на миграцию, а не паниковать.
retired — модель отключена автором. Запрос возвращает 404. Мы не подменяем снятую модель на похожую молча: подмена под тем же идентификатором ломает воспроизводимость сильнее, чем честный отказ.

Чтобы отключение не будило вас ночью, укажите резервные модели: при 404 запрос уйдёт следующей из списка.

Суффиксы

К идентификатору можно приписать суффикс через двоеточие — deepseek/deepseek-v3:nitro. Это короткая запись правила маршрутизации для тех случаев, когда городить блок provider ради одного условия не хочется. Полный список — в разделе «Суффиксы моделей».