Як читати назви AI-моделей: псевдонім проти закріпленої версії

Відкрийте будь-яку сторінку AI 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 — це псевдонім: станом на 22 жовтня 2026 документація DeepSeek каже, що його обслуговує 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 is out.

Що перевірити, перш ніж вставляти id у код#

1. Копіюйте id з документації того провайдера, якого ви насправді викликаєте. Різні провайдери називають ту саму родину по-різному, тому беріть id з документації CheapTokens, коли викликаєте CheapTokens, і з документації DeepSeek, коли викликаєте DeepSeek. Не змішуйте їх.
2. Вирішіть: псевдонім чи закріплений? Якщо в рядку немає дати або суфікса збірки, припускайте, що він може змінитися.
3. Перевірте базову 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 на неправильній базовій 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)

Два надруковані рядки — це звичка, яку варто виробити: що ви попросили і що відповіло. Ніколи не вписуйте ключ жорстко в код; див. What is an API key and how to store it safely. Якщо це ваш перший виклик, почніть з Your first API request with CheapTokens.

Порівнюйте ціни та результати версія за версією#

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

Це працює і в зворотному напрямку. Коли ви тестуєте модель на власних промптах, тримайте набір промптів фіксованим і змінюйте по одній речі за раз: id або промпт, але не обидва. Рахуєте токени для порівняння? What is a token пояснює, як вимірюються ці числа.

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

CheapTokens тримає один баланс для всіх моделей, тож ви можете перемикати id з тим самим ключем:

• MiniMax-M2.7 (minimax-m2.7, 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.