DeepSeek API: ключ, цены и подключение

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

Что даёт DeepSeek API и кому он нужен

• Автоматизация. Массовая обработка документов, разметка, суммаризация, извлечение данных в JSON.
• Свои продукты. Чат-боты, помощники в интерфейсе, генерация текстов в CRM.
• Агенты и код. DeepSeek официально поддерживается в Claude Code, OpenCode и собственном Harness.
• Отсутствие лимитов чата. Ограничения здесь не «запросов в сутки», а параллельные соединения: 2500 для Flash и 500 для Pro.

Если вы просто общаетесь с моделью руками, API не нужен — хватит веб-чата. Если вы хотите встроить модель в процесс, API дешевле и надёжнее любого интерфейса.

Как получить ключ

1. Зарегистрируйтесь на platform.deepseek.com (вход через email или Google).
2. Откройте раздел API Keys и создайте ключ. Он показывается один раз — сохраните сразу.
3. Пополните баланс. Без положительного баланса запросы возвращают ошибку 402.
4. Проверьте ключ тестовым запросом — он должен отвечать, а не только создаваться.

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

Первый запрос: curl

curl https://api.deepseek.com/chat/completions -H "Content-Type: application/json" -H "Authorization: Bearer $DEEPSEEK_API_KEY" -d '{"model": "deepseek-flash", "messages": [{"role": "user", "content": "Объясни в трёх предложениях, что такое MoE"}], "stream": false}'

Первый запрос: Python

DeepSeek совместим с OpenAI SDK, поэтому отдельная библиотека не нужна — достаточно подменить базовый адрес.

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
)

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Сократи текст до 500 знаков: ..."}],
    extra_body={"reasoning_effort": "high"},
)
print(resp.choices[0].message.content)

Для Anthropic-формата базовый адрес другой: https://api.deepseek.com/anthropic. Это удобно, если ваш клиент написан под Claude.

Модели и режимы

Имя в API	Версия	Картинки	Когда брать
deepseek-flash	V4.1-Flash-1017	да	по умолчанию: быстро, дёшево, с изображениями
deepseek-v4-pro	V4-Pro-0813	нет	сложная математика, код, максимальная глубина

Глубина рассуждений задаётся параметром reasoning_effort: low, high или max. По умолчанию включён thinking-режим уровня high. Для извлечения данных и перевода ставьте non-thinking или low — получите двукратную экономию времени и денег.

Цены на ноябрь 2026

Показатель (за 1 млн токенов)	deepseek-flash	deepseek-v4-pro
Вход, кэш-промах — пик	$0,30	$1,32
Вход, кэш-промах — вне пика	$0,14	$0,66
Вход, кэш-попадание — пик	$0,006	$0,044
Выход — пик	$1,20	$3,96
Выход — вне пика	$0,60	$1,98
Параллельных запросов	2500	500

Пиковые часы: 01:00–04:00 и 06:00–10:00 UTC по будням. Всё остальное время, а также выходные и праздники Китая — половинный тариф. Для Москвы это значит, что ночные пакетные задачи почти всегда идут по минимальной цене.

Кэш. Кэширование префикса включается автоматически: если вы отправляете один и тот же системный промпт и документ повторно, вход считается по цене кэш-попадания — в 50 раз дешевле. Это главный рычаг экономии в агентных сценариях, где контекст переиспользуется.

Пример расчёта

Обработка 1000 карточек товара: по 800 входящих и 200 исходящих токенов на каждую.

• Вход: 800 × 1000 = 800 тыс. токенов → $0,12 (flash, вне пика)
• Выход: 200 × 1000 = 200 тыс. токенов → $0,12
• Итого: около $0,24 за тысячу карточек.

Для сравнения, те же 1000 карточек на GPT-5.4 стоили бы порядка $2,3 только за вход.

Дополнительные возможности

Возможность	Что даёт
JSON Output	гарантированный JSON в ответе — для парсинга и пайплайнов
Tool Calls	вызов ваших функций, агентные сценарии
Responses API	новый формат OpenAI, удобен для Codex-подобных клиентов
Anthropic API	совместимость с клиентами Claude
Chat Prefix Completion (beta)	продолжение ответа с заданного префикса
FIM Completion (beta)	вставка кода в середину файла, только без режима мышления
Vision	передача изображений, только deepseek-flash
Search и Fetch API	поиск и загрузка страниц, $0,75 за 1000 запросов

Важно про Search и Fetch: при работе через DeepSeek Harness, Claude Code и Codex серверные вызовы поиска до 1 ноября 2026 года включены бесплатно, дальше тарифицируются по запросам. Если строите продукт с поиском, закладывайте это в бюджет.

Частые ошибки

Код	Что значит	Что делать
401	неверный или отозванный ключ	перевыпустить ключ, проверить пробелы и кавычки
402	недостаточно средств	пополнить баланс
429	превышен лимит параллельных запросов	снизить конкурентность, добавить очередь и retry с задержкой
500 / 503	сбой на стороне сервиса	повторить через 2–5 секунд, экспоненциальный backoff

В DeepSeek API классическая ошибка новичка — не обрабатывать 429 и запускать 5000 параллельных задач. Модель отвечает, но половина запросов падает, а деньги списываются. Ставьте ограничение на 10–20 одновременных соединений, и вы получите почти ту же скорость без потерь.

Пополнение из России

Оплата на platform.deepseek.com требует иностранную карту. Российские карты не проходят, поэтому на практике используют зарубежную карту, посредников или сторонние платформы-провайдеры, которые принимают оплату в рублях и предоставляют OpenAI-совместимый эндпоинт. Во втором случае меняется только base_url и ключ, код остаётся тем же.

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

Когда API не нужен

DeepSeek API оправдан не всегда. Если задача — «написать текст», «разобрать документ руками» или «проверить идею», API добавит вам только инфраструктуру. API оправдан там, где есть поток задач, и где стоимость ручной работы выше стоимости токенов. Как формулировать запросы, чтобы результат был предсказуемым — в статье 25 промптов для DeepSeek; какую модель выбирать — в материале модели DeepSeek.

Стриминг и JSON: два приёма, без которых неудобно

Стриминг нужен везде, где человек ждёт ответа в интерфейсе: без него пользователь смотрит на пустой экран 10–20 секунд и решает, что «сломалось».

stream = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Напиши план статьи"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

JSON-вывод — обязательный приём для пайплайнов. Включается параметром response_format={"type": "json_object"}, но работает только если в промпте явно сказано, что нужен JSON, и описана схема. Иначе модель вернёт валидный JSON с произвольными полями.

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": 'Отвечай только JSON: {"итог": str, "риски": [str]}'},
        {"role": "user", "content": text},
    ],
    response_format={"type": "json_object"},
)

Всегда оставляйте в коде проверку схемы и повторный запрос при ошибке разбора: даже с включённым JSON-режимом модель иногда добавляет текстовое вступление.

Как считать стоимость заранее

Формула стоимости DeepSeek API простая: (вход ÷ 1 млн × цена входа) + (выход ÷ 1 млн × цена выхода). Дальше умножаем на количество запросов и на коэффициент пикового времени.

Задача	Токенов вход/выход	Стоимость flash (вне пика)
Короткий ответ в чате	500 / 300	≈ $0,0003
Разбор документа на 100 страниц	150 000 / 3 000	≈ $0,024
1000 карточек товара	800 000 / 200 000	≈ $0,24
Агентная сессия на 50 шагов	2 000 000 / 100 000	≈ $0,36

Цифры показывают главное: при ценах DeepSeek бюджетами управляет не выбор модели, а объём контекста. Поэтому кэш префикса и отключение лишней истории дают больший эффект, чем переход с Pro на Flash.