API DeepSeek: цены, лимиты и как это устроено

API — единственное, за что разработчик берёт деньги. Разбираем прайс, объясняем, почему цена входа отличается в сто с лишним раз, считаем стоимость реального запроса и перечисляем ограничения, о которых стоит знать заранее.

Кому нужен API и кому не нужен

API — это доступ к модели из чужой программы: ваш код отправляет запрос и получает ответ, без сайта и без интерфейса. Нужен он в трёх случаях: вы встраиваете модель в свой продукт, обрабатываете данные пачками или подключаете модель к редактору кода и другим инструментам.

Обычному пользователю чата API не нужен и ничего не даёт. Это стоит сказать прямо, потому что ожидания часто обратные: оплата API не расширяет возможности чата — не убирает «сервер занят», не увеличивает длину диалога, не открывает скрытых функций. Это два разных продукта с разными аккаунтами; подробности про два кабинета — в разделе об официальном сайте.

Эндпоинты и два формата запросов

Базовый адрес — https://api.deepseek.com. Интерфейс совместим с форматом OpenAI: в большинстве библиотек достаточно заменить базовый URL и ключ, а код запроса остаётся прежним. Дополнительно поддерживается формат Anthropic — по адресу https://api.deepseek.com/anthropic¹. Идея простая: не заставлять переписывать интеграцию ради смены модели.

Имена моделей в запросах — deepseek-v4-pro и deepseek-v4-flash. Ключи и баланс живут в кабинете разработчика на platform.deepseek.com, документация — на api-docs.deepseek.com.

Из инструментов документированы вызовы функций (tool calls) — то, на чём строятся агентские сценарии. А вот встроенного поиска в интернете в API нет: поиск, который вы видите в чате, — функция чата, а не модели. В своём приложении поиск придётся подключать самостоятельно.

Цены и что такое попадание в кэш

Две колонки на вход — не опечатка. Разработчик кэширует контекст: если начало вашего запроса совпадает с началом предыдущего (тот же системный промпт, та же инструкция, тот же документ), повторно считать его не нужно, и такие токены стоят кратно дешевле: примерно в 50 раз у V4-Flash и в 120 раз у V4-Pro.

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

Сколько стоит реальный запрос

Абстрактные «доллары за миллион» плохо ложатся на интуицию, поэтому посчитаем. Возьмём типичный запрос: 8 000 токенов на входе (инструкция плюс кусок документа) и 1 500 токенов ответа.

То есть тысяча полноценных обращений к младшей модели стоит около полутора долларов, к старшей — около пяти. Если при этом инструкция повторяется от запроса к запросу и попадает в кэш, входная часть счёта уменьшается ещё в разы.

Лимиты и отсутствие бесплатного тарифа

Бесплатного уровня у API нет: пробных токенов на новый аккаунт не начисляют, работа идёт с баланса. Это важное отличие от чата — чат бесплатен целиком, API платен целиком.

Ограничение, о котором стоит знать заранее, — конкурентность, то есть сколько запросов можно держать одновременно: 500 у V4-Pro и 2 500 у V4-Flash. Расширение лимита разработчик предоставляет по заявке и, судя по документации, бесплатно ³. Для большинства проектов эти цифры избыточны; упереться в них можно только при массовой пакетной обработке.

Миллион токенов контекста на практике

Контекст обеих моделей V4 — миллион токенов, максимальная длина ответа — 384 тысячи. Чтобы перевести это в понятные величины: миллион токенов русского текста — это грубо триста-четыреста тысяч слов, то есть несколько толстых книг разом. На таком объёме модель показывает 83,5% в тесте MRCR на поиск информации в длинном контексте — заявка серьёзная, но проверять на своей задаче всё равно стоит: качество работы с длинным контекстом падает неравномерно и зависит от того, где именно в тексте лежит нужный факт.

Практическая оговорка: это цифры API. В веб-чате диалог упирается в предел заметно раньше — что делать в этом случае, разобрано в разделе про ошибки.

Оплата и юридическая сторона

Официального перечня способов оплаты разработчик не публикует: платёжный раздел находится за авторизацией в кабинете. Что известно точно и что важнее способа оплаты: юридического лица в России у компании нет, пользовательское соглашение подчинено праву КНР, споры отнесены к судам Ханчжоу, а данные обрабатываются и хранятся в КНР ⁴. Для личного проекта это чаще всего не имеет значения, для корпоративного контура — имеет; подробный разбор в разделе о данных.

Альтернатива, которая снимает вопрос целиком: развернуть модель у себя. Веса открыты под MIT, и в этом случае никакого договора с разработчиком не требуется вовсе.

Короткие ответы