API DeepSeek — это два эндпоинта и два названия моделей — вот что принимает каждый из них.

DeepSeek API выглядит проще, чем есть на самом деле. Есть два базовых URL, два идентификатора моделей и матрица возможностей, где два столбца почти идентичны — кроме одной строки, которая решает, возможна ли ваша задача в принципе. Если вы переходите с OpenAI SDK, вам нужен один из них; если переходите с обвязки в стиле Anthropic — другой; а если вы отправляете скриншоты, их примет только одна из двух моделей.

Две базы

• Формат OpenAI — code>https://api.deepseek.com/code>. Chat completions в формате OpenAI, включая Responses API, вывод JSON, вызовы инструментов и завершение по префиксу в бета-версии.

• Формат Anthropic — code>https://api.deepseek.com/anthropic/code>. Те же две модели за интерфейсом в форме Anthropic — именно это и нужно инструменту для работы с кодом, который говорит на таком протоколе.

Обе базы обслуживают обе модели. Выбор базы связан с вашей клиентской библиотекой, а не с возможностями.

Два имени — и что за каждым из них

• deepseek-flash —в настоящее время обслуживается DeepSeek-V4.1-Flash-1017, октябрьским чекпойнтом. Мультимодальная: на входе текст и изображения, на выходе текст. Контекст 1M, максимальный объём вывода 384K, 2 500 одновременных запросов.

• deepseek-v4-pro — обслуживается DeepSeek-V4-Pro-0813. Только текст. Тот же контекст 1M и вывод 384K, 500 одновременных запросов.

Два устаревших идентификатора всё ещё принимаются — code>deepseek-v4-flash/code> и code>deepseek-v4-flash-vision-exp/code> — но документация DeepSeek прямо указывает, что соответствующие модели выведены из эксплуатации, что запросы обслуживаются V4.1-Flash-1017 и что тарификация идёт по цене Flash. На практике это означает, что старая интеграция продолжает работать и незаметно начинает возвращать ответы другой модели, и это стоит проверить, прежде чем связывать изменение в выводе с чем-либо ещё.

Матрица функций, строка за строкой

Почти всё является общим. Именно из-за исключений это руководство и существует.

• Режим размышления —обе модели поддерживают работу без размышления и с размышлением, причём размышление включено по умолчанию. Уровни усилий — низкий, высокий и максимальный; рекомендации DeepSeek: низкий для простых задач, высокий для повседневной работы агентов, максимальный для более сложных сценариев.

• Вывод JSON, вызовы инструментов, дополнение префикса — одинаково поддерживаются в обоих. Дополнение префикса находится в бета-версии.

• Responses API и Anthropic API —оба поддерживаются на обеих моделях, что необычно и полезно знать: любую из моделей можно использовать через любую клиентскую форму без слоя трансляции.

• FIM completion — бета-версия на обоих, а режим без размышлений — только на обоих. Если ваш сценарий использования — заполнение кода, это ограничение распространяется и на флагман.

• Vision —галочка для code>deepseek-flash/code>, «Не поддерживается» для code>deepseek-v4-pro/code>. Это единственная развилка в матрице, и её нельзя обойти изменением промпта.

Что идентификаторы подразумевают о стоимости

В самих названиях заложена структура цен. У Flash вход — $0,15, выход — $0,60 за миллион токенов, попадание в кэш — $0,003; у V4 Pro — $0,66 и $1,98, попадание в кэш — $0,022. Обе цены удваиваются в периоды 01:00–04:00 и 06:00–10:00 UTC с понедельника по пятницу. Таким образом, выбранное название модели определяет и возможности, и стоимость, а указанные выше устаревшие названия задают стоимость по тарифу Flash независимо от того, какой чекпоинт отвечает.

Одно практическое следствие: поскольку code>deepseek-flash/code> теперь указывает на контрольную точку, выпущенную в октябре, модель затрат или базовый показатель качества, рассчитанные для сентябрьской модели, описывают то, чего вы больше не получаете под этим идентификатором. Не привязывайте ничего к названию, которое вы не перепроверили в этом месяце.

Как это сравнить со слоем маршрутизации

Собственная поверхность DeepSeek — это две модели за двумя протоколами. Если вашему приложению всегда нужна только самая сильная модель DeepSeek, этого достаточно. Случаи, когда этого недостаточно, — это те, которые данная форма не может выразить: выбор резервного варианта на случай сбоя у провайдера, композиция DeepSeek с моделью другого вендора в одном рабочем процессе или A/B-тестирование Flash против Pro на живом трафике без двух отдельных интеграций.

Для этого и нужен совместимый с OpenAI эндпоинт OrcaRouter на 224 модели, а DeepSeek V4 Pro и V4.1 Flash оба доступны через него по опубликованным тарифам DeepSeek без наценки — включая строку с попаданием в кэш и удвоение в часы пик, поскольку цена поставщика передаётся как есть. Эндпоинты, указанные выше, по-прежнему работают ровно так, как описано в документации DeepSeek; роутер не заменяет API поставщика — он даёт вам одно место для переключения между несколькими из них.

Чек-лист миграции, по порядку

• Выбирайте базу исходя из формы вашего клиента, а не из модели, которую вы хотите.

• Выбирайте модель по тому, что отправляете: изображения означают Flash, работа только с текстом — решает цена.

• Явно задайте усилие на обдумывание, вместо того чтобы наследовать значение по умолчанию, поскольку по умолчанию обдумывание включено.

• Проверьте, не был ли ваш старый идентификатор выведен из эксплуатации под вами — два устаревших имени принимаются, пересчитываются и обслуживаются повторно.

• Сначала измерьте долю попаданий в кэш, а затем оценивайте ежемесячный счёт, поскольку стабильный префикс даёт 30-кратную скидку, а нестабильный — ничего.