Как читать названия ИИ-моделей: алиас и версия

Откройте страницу любого API для ИИ — и вы увидите названия вроде deepseek-flash, deepseek-v4-pro или DeepSeek-V4-Flash-0731. Выглядит как подпись, но строка в поле model решает, какая модель ответит и сколько с вас спишут. Здесь разберём, как читать такие названия, почему одно и то же имя может меняться, и что проверить, прежде чем вставлять id в код.

Из чего состоит название модели#

Возьмём DeepSeek-V4-Flash-0731 и разберём по частям:

Две оговорки. Суффикс — это договорённость, а не закон: 1017 совпадает с датой выпуска DeepSeek-V4.1-Flash-1017 (17 октября 2026 года), но всегда сверяйте это на странице модели, а не угадывайте. И название на странице документации (DeepSeek-V4-Flash) — не всегда та строка, которую принимает API (deepseek-v4-flash-0731): отображаемое имя — для людей, id — для кода.

Flash и Pro#

Разработчики обычно выпускают несколько уровней одного поколения. Flash — как правило, более быстрый и лёгкий уровень для больших объёмов: чат, извлечение данных, циклы агентов. Pro — как правило, более крупный уровень для сложных задач. Эти слова — маркетинг самого разработчика, поэтому между семействами их сравнивать нельзя: Flash одной компании не равен по размеру Flash другой. Важно другое: deepseek-flash и deepseek-v4-pro — два разных названия модели, поэтому смотрите таблицу цен той, которую используете. Меняете уровень — перепроверьте таблицу цен.

Алиас и закреплённая версия#

Есть два вида id, и разница между ними — главное в этой статье.

• Алиас — имя, которое провайдер направляет на какую-то модель и может позже перенаправить. deepseek-flash — алиас: по документации DeepSeek на 22 октября 2026 года его обслуживает DeepSeek-V4.1-Flash-1017, способ вызова не менялся. Завтра та же строка может вести на более новую сборку.
• Закреплённая версия — id, в котором есть сборка, например deepseek-v4-flash-0731. Он указывает на одну конкретную сборку, поэтому ответы, которые вы проверили вчера, сегодня должна давать та же сборка.

Алиас удобен: улучшения приходят без правки кода. Закреплённый id предсказуем: подходит для тестов, оценок, отчётов и всего, где смена поведения была бы неприятным сюрпризом. «Лучшего» варианта нет — выбирайте осознанно.

Одно и то же имя может измениться#

Изменение у DeepSeek в октябре 2026 года — живой пример. По документации DeepSeek, проверено 22 октября 2026 года:

• deepseek-flash сейчас обслуживает DeepSeek-V4.1-Flash-1017;
• старые имена deepseek-v4-flash и deepseek-v4-flash-vision-exp всё ещё принимаются, но эти модели выведены из обращения: запросы идут в DeepSeek-V4.1-Flash-1017 и тарифицируются по цене Flash;
• deepseek-v4-pro — отдельное актуальное название модели.

То есть старый код может продолжать работать и при этом запускать не ту модель, что в день написания. Это нормально, если вам нужна самая свежая, и ловушка, если вы сравнивали результаты за несколько недель. На странице документации нет даты публикации, поэтому считайте соответствие верным на указанную дату и перечитайте его, когда это важно. Что изменилось в самой модели — в материале DeepSeek-V4.1-Flash-1017 вышла.

Что проверить, прежде чем вставлять id в код#

1. Копируйте id из документации того провайдера, к которому реально обращаетесь. У разных провайдеров одно семейство называется по-разному: вызываете CheapTokens — берите id из документации CheapTokens, вызываете DeepSeek — из документации DeepSeek. Не смешивайте.
2. Решите: алиас или закреплённая версия? Если в строке нет даты или суффикса сборки, считайте, что она может сместиться.
3. Проверьте base URL и формат API. CheapTokens работает в форматах OpenAI Chat Completions и Anthropic Messages по адресу https://api.cheaptokens.dev/v1; собственный API DeepSeek — https://api.deepseek.com (формат OpenAI) и https://api.deepseek.com/anthropic (формат Anthropic). Верный id на неверном base URL — это ошибка.
4. Откройте таблицу цен именно для этого id и запишите дату. Цены принадлежат модели, а не семейству.
5. Храните id в одном месте (конфиг или переменная окружения), а не по всему коду.
6. Логируйте, какая модель ответила. В ответах в стиле OpenAI есть поле model; сохраняйте его рядом с результатами.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)

# Take the exact id from the CheapTokens docs; this one is an example.
MODEL_ID = os.environ.get("MODEL_ID", "minimax-m2.7")

response = client.chat.completions.create(
    model=MODEL_ID,
    messages=[{"role": "user", "content": "Say hello in five words."}],
    max_tokens=50,
)

print("asked for:", MODEL_ID)
print("answered by:", response.model)
print(response.choices[0].message.content)

Две выведенные строки — привычка, которую стоит завести: что вы просили и кто ответил. Ключ никогда не вписывайте в код, см. Что такое API-ключ и как его хранить. Если это ваш первый вызов, начните с Первого запроса к API через CheapTokens.

Сравнивайте цены и результаты версия к версии#

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

И в обратную сторону: тестируя модель на своих промптах, держите набор промптов неизменным и меняйте что-то одно — id или промпт, но не оба сразу. Считаете токены для сравнения? В материале Что такое токен объяснено, как измеряются эти числа.

Примеры id для практики#

В CheapTokens один баланс на все модели, поэтому на одном ключе можно переключать id:

• MiniMax-M2.7 (minimax-m2.7, gateway id MiniMaxAI/MiniMax-M2.7): контекст 180K, до 8 192 токенов в ответе, одна цена в любое время суток. Вход $0.05 и выход $0.15 за 1M токенов — обе стороны ниже референса OpenRouter.

Таблица ниже пересчитывается вживую для небольшой задачи в 100 000 входных и 20 000 выходных токенов, с колонкой OpenRouter для сравнения:

Каждая строка — это один конкретный id. Если вы замените minimax-m2.7 другим id, поменяются и модель, и цена.

Коротко#

• Строка model решает, какая модель ответит и сколько это стоит.
• Id без суффикса сборки, скорее всего, алиас и может быть перенаправлен; id со сборкой — закреплённая версия.
• Старые имена могут продолжать работать, незаметно запуская более новую модель, как deepseek-v4-flash в документации DeepSeek на 22 октября 2026 года.
• Flash и Pro — уровни внутри одного семейства, а не универсальные размеры.
• Всегда копируйте id из документации того провайдера, которого вызываете, и логируйте, какая модель ответила.

Готовы попробовать? Получите ключ, пополните баланс и отправьте сниппет выше с id модели из документации CheapTokens.