Какой model id писать: deepseek-flash vs aliases

Если вы уже пишете интеграции под несколько LLM (Qwen, DeepSeek и соседние OpenAI-совместимые API), вопрос обычно не «что такое Flash», а какой строковый model оставить в коде. Ниже — cheat-sheet для интеграторов: предпочтительный id deepseek-flash, legacy Flash-алиасы и отдельно deepseek-v4-pro.

Зачем этот cheat-sheet, а не обзор «что нового»

Релиз V4.1-Flash и feature-тур по multimodal/контексту — отдельная тема. Здесь узкий практический срез:

что писать в поле model / model_id сегодня;
какие старые имена ещё «работают» за счёт роутинга;
почему нельзя путать Flash-алиасы с Pro;
какой источник доверять, если news-карточка и Pricing расходятся.

Материал рассчитан на разработчиков и DevOps, которые держат конфиги агентов, IDE-плагинов и бэкенд-прокси. Цифры цен в статью не копируем — только имена моделей и политика роутинга по Docs на дату сверки.

Базовые понятия: id, алиас, продукт

В DeepSeek API (OpenAI-совместимый формат) вы передаёте строковый идентификатор модели. Он не обязан совпадать с маркетинговым названием на сайте.

Продукт / семейство: DeepSeek-V4.1-Flash, DeepSeek V4 Pro и т.п. — то, что видите в news и на Hugging Face.
API model id: то, что уходит в JSON запроса, например deepseek-flash.
Legacy alias: старое имя, которое API временно принимает и направляет на актуальную модель.

Путаница возникает, когда в репозитории остаётся алиас из прошлого спринта, а в доках уже другой preferred id. Для Flash на дату сверки preferred — deepseek-flash.

Cheat-sheet: какой model id писать

Что пишете в `model`	Куда реально уходит (по Docs, сверка 14.09.2026)	Рекомендация интегратору
`deepseek-flash`	DeepSeek-V4.1-Flash	Предпочтительный id для новых и обновляемых интеграций Flash
`deepseek-v4-flash`	временно роутится на V4.1-Flash (тариф Flash)	Работает для совместимости; в новом коде не оставлять как канон
`deepseek-v4-flash-vision-exp`	временно роутится на V4.1-Flash (тариф Flash)	То же: legacy / vision-exp alias, не preferred
`deepseek-v4-pro`	DeepSeek-V4-Pro (отдельная колонка в Models & Pricing)	Не Flash. После 14.09.2026 API Pro продолжается с прежним биллингом до отдельного notice

Короткое правило: для Flash-трафика в проде пишите deepseek-flash. Legacy Flash-алиасы можно терпеть в переходный период, но план миграции — на preferred id. Pro — отдельная ветка конфига, не «старое имя Flash».

Практика: минимальные примеры кода

Ниже — плейсхолдеры. Подставьте свой ключ из кабинета платформы; не коммитьте секреты.

cURL (OpenAI-совместимый endpoint)

curl https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer sk-YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-flash",
    "messages": [
      {"role": "user", "content": "Кратко: чем model id отличается от имени продукта?"}
    ]
  }'

Python (openai SDK, base_url)

from openai import OpenAI

client = OpenAI(
    api_key="sk-YOUR_API_KEY_HERE",
    base_url="https://api.deepseek.com",
)

resp = client.chat.completions.create(
    model="deepseek-flash",  # preferred Flash id
    messages=[{"role": "user", "content": "ping"}],
)
print(resp.choices[0].message.content)

Конфиг агента: Flash vs Pro split

# Пример .env / yaml — не смешивать id в одной переменной без явного смысла
DEEPSEEK_FLASH_MODEL=deepseek-flash
DEEPSEEK_PRO_MODEL=deepseek-v4-pro

# Устарело как канон (только если нужен временный back-compat):
# DEEPSEEK_FLASH_MODEL=deepseek-v4-flash

Если у вас уже зашиты deepseek-v4-flash или deepseek-v4-flash-vision-exp, запросы могут ещё проходить за счёт временного роутинга на V4.1-Flash. Это не повод считать алиас «вечным» — при любом рефакторинге переводите константы на deepseek-flash.

Pro отдельно: что не путать с Flash-алиасами

В сентябре 2026 в публичном поле рядом оказались два текста:

News-карточка (news260910) — изначально описывала план роутинга deepseek-v4-pro → V4.1-Flash с 14.09.2026.
Актуальная политика в Models & Pricing / Change Log — на сверку 14.09.2026: DeepSeek продолжает предоставлять API V4 Pro после 14 сентября 2026 с неизменным методом биллинга; при изменениях будет отдельный notice.

Для операторов и CI-конфигов ориентир — Pricing + Change Log, а не одна только news-страница. Итог для кода:

новые Flash-интеграции → deepseek-flash;
Pro, если он вам нужен осознанно → deepseek-v4-pro (пока Docs держат его отдельно);
не обещать себе и команде, что Pro «навсегда» — формулировка вендора: further notice при изменениях.

Если нужна обзорная точка входа по DeepSeek на русском — базовые DeepSeek: инструкции и FAQ помогут сориентироваться: гайды и FAQ без привязки к одному узкому API-кейсу.

Сценарии: что менять в коде прямо сейчас

Три типовых состояния репозитория и действие без лишней драмы:

Новый сервис / новый агент. Сразу deepseek-flash. Не копируйте алиасы из старых gist «на всякий случай» — они только засоряют канон.
Прод с deepseek-v4-flash или deepseek-v4-flash-vision-exp. Запросы могут ещё ходить за счёт временного роутинга на V4.1-Flash. Заведите задачу на замену константы + smoke-тест chat/completions; в MR опишите «legacy alias → preferred id», не «миграция на другую модель ради фич».
Двухконтурная схема Flash + Pro. Два env: Flash = deepseek-flash, Pro = deepseek-v4-pro. Роутер в коде выбирает контур по SLA/задаче, а не по «какое имя короче». После 14.09.2026 не удаляйте Pro-контур только потому, что news-карточка пугала cutover — сверяйте Pricing.

Для команд, которые уже держат Qwen и DeepSeek в одном адаптере: храните map vendor → model_id в одном месте (enum/config), чтобы смена preferred id DeepSeek не размазалась по десяти воркерам.

Типичные ошибки интеграторов

Считать любой «flash» в строке одинаковым. Preferred — deepseek-flash; deepseek-v4-flash* — legacy aliases с временным роутингом.
Подменить Pro на Flash «на всякий случай» без продуктового решения. Это разные id и разная политика биллинга; «на всякий» ломает ожидания по качеству/стоимости.
Копировать цены в README из чужих статей. Прайс меняется; в репозитории лучше ссылка на Models & Pricing + дата сверки.
Оставлять beta-имена вроде временных expires-on id из короткой API-беты (если они ещё где-то в истории коммитов) — для продакшена не использовать.
Путать чат на chat.deepseek.com и API model id. UI-чат ≠ строка в SDK; для автоматизации нужен platform key и явный model.

Чеклист перед мержем конфига

[ ] В новом коде Flash = deepseek-flash
[ ] Поиск по репо: нет ли канонизации deepseek-v4-flash / deepseek-v4-flash-vision-exp без комментария «legacy»
[ ] Pro вынесен в отдельный флаг/env, не замаскирован под Flash
[ ] В README — ссылка на Models & Pricing и Change Log, дата сверки
[ ] Секреты только в env/secret store; в примерах — sk-YOUR_API_KEY_HERE

FAQ

Какой model id писать для Flash прямо сейчас?
deepseek-flash — предпочтительный id V4.1-Flash по Docs на сверку 14.09.2026.

Можно ли оставить deepseek-v4-flash в старом сервисе?
По документации алиасы deepseek-v4-flash и deepseek-v4-flash-vision-exp временно роутятся на V4.1-Flash. Для совместимости ок кратко; для канона в новом коде — нет.

Пропадёт ли deepseek-v4-pro после 14 сентября 2026?
По актуальному Pricing (сноска про V4 Pro) и Change Log — нет: API Pro продолжается с прежним биллингом; изменения — по further notice. News260910 с планом роутинга на Flash считайте устаревшим относительно Pricing/Change Log.

Это то же самое, что «что нового в V4.1-Flash»?
Нет. Здесь только карта id/алиасов для кода. Feature-обзор multimodal и архитектуры — другая статья.

Где сверять перед релизом?
Первично: Models & Pricing и Change Log на api-docs.deepseek.com. Вторично: news и HF-карточка модели. Мы описываем тему для читателей qwen-ai.ru; это не портал разработчика DeepSeek.

Нужен ли отдельный id для vision?
Для вызова через API на дату сверки ориентир — preferred deepseek-flash (V4.1-Flash с native vision по материалам Docs/HF). Legacy deepseek-v4-flash-vision-exp — временный алиас, не новый «правильный» id.

Источники / Research

FACT · Preferred id deepseek-flash → V4.1-Flash · Models & Pricing, Change Log · сверка 14.09.2026
FACT · Legacy deepseek-v4-flash / deepseek-v4-flash-vision-exp временно → V4.1-Flash · Pricing + Change Log · сверка 14.09.2026
FACT · V4 Pro API продолжается после 14.09.2026, billing unchanged, further notice · Pricing footnote · сверка 14.09.2026
FACT · news260910 сохраняет старый план Pro→Flash · news260910 · сверка 14.09.2026 — для интеграций вторичен относительно Pricing
FACT · Анонс / веса V4.1-Flash · deepseek.com news, HF DeepSeek-V4.1-Flash

Гипотез о точных ¥/$ ставках и сроках снятия алиасов в тексте нет — только то, что прямо следует из Docs на дату сверки.

Итог

В новом коде для Flash пишите deepseek-flash.
Legacy Flash-алиасы пока роутятся на V4.1-Flash — удобно для back-compat, плохо как вечный канон.
deepseek-v4-pro — не алиас Flash; на 14.09.2026 Pro API продолжается с прежним биллингом до notice.
Сверяйте Pricing + Change Log чаще, чем одну news-карточку.
Цены в статью и README не копируйте таблицей — ссылайтесь на Docs.

Мы описываем тему для читателей ниши LLM/API на qwen-ai.ru; это не продукт DeepSeek-AI. перед запуском перечитайте актуальные Docs — model id и политика роутинга могут обновиться отдельным notice.