DeepSeek API: как получить ключ и отправить первый запрос

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

Ниже — практический путь от получения ключа до первого запроса, актуальные названия моделей и расчёт стоимости. Возможности и тарифы проверены 19 октября 2026 года. Примеры показывают обращение к официальному API; при использовании посредника адрес, ключ и правила оплаты будут другими.

Какие модели доступны через DeepSeek API

В официальной документации сейчас указаны два основных имени для вызовов:

У обеих моделей заявлено контекстное окно до миллиона токенов — единиц текста, которые обрабатывает модель. Это верхняя граница, а не рекомендуемый размер первого запроса. Чем больше переданных материалов, тем выше расход и потенциальное время обработки.

Вызов deepseek-flash направляется на актуальную версию, поэтому короткое имя не фиксирует поведение навсегда. Для повторяемых проверок записывайте дату, имя модели, параметры и результаты. В старых уроках встречаются deepseek-chat и deepseek-reasoner; здесь используем имена из действующего справочника.

Как получить DeepSeek API key

1. Откройте официальную API-платформу platform.deepseek.com и войдите в свою учётную запись.
2. В разделе API-ключей создайте ключ для приложения и сохраните его в настройках серверного окружения.
3. Проверьте доступный баланс и условия пополнения в кабинете. Наличие ключа ещё не означает, что есть средства для запроса.
4. Передайте ключ программе через переменную окружения DEEPSEEK_API_KEY.

Для сайта запрос лучше выполнять на своём сервере. Ключ, помещённый в JavaScript страницы, посетитель сможет получить из загруженного кода или сетевых запросов. Браузер обращается к вашему обработчику, а обработчик — к DeepSeek.

Не вставляйте рабочий ключ в статью, публичный репозиторий или текст запроса к модели. Если используется файл .env, его нужно исключить из Git и явно подключить механизм загрузки переменных. Python сам по себе такой файл не читает.

Первый запрос: адрес, модель и сообщения

В формате Chat Completions официальный адрес запроса — https://api.deepseek.com/chat/completions. Авторизация передаётся заголовком Authorization: Bearer …. В теле нужны имя модели и массив сообщений messages.

Документация описывает совместимость с форматами OpenAI и Anthropic. Для первого примера обойдёмся обычным HTTP-запросом через Python, чтобы явно увидеть адрес, заголовки и параметры. В отдельном виртуальном окружении установите пакет:

python -m pip install requests

Пример использует переменную окружения, короткую задачу и выключенный режим рассуждений. Переменная должна быть задана в той среде, из которой запускается Python. Сохраните код в deepseek_example.py:

import os
import requests

api_key = os.environ["DEEPSEEK_API_KEY"]

response = requests.post(
    "https://api.deepseek.com/chat/completions",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "deepseek-flash",
        "messages": [
            {"role": "system", "content": "Отвечай кратко и по-русски."},
            {"role": "user", "content": "Объясни кеширование сайта в трёх пунктах."},
        ],
        "thinking": {"type": "disabled"},
        "max_tokens": 512,
        "stream": False,
    },
    timeout=(10, 90),
)
response.raise_for_status()
result = response.json()
print(result["choices"][0]["message"]["content"])
print(result.get("usage", {}))

Это пример на основе документированного API, а не отчёт о нашем платном тесте. Параметр max_tokens ограничивает ответ, stream: false запрашивает его целиком. Тайм-аут в 90 секунд выбран для короткой пробы; в рабочем приложении его подбирают под задачу и обрабатывают сетевые ошибки.

В поле usage возвращается информация о расходе токенов. Сохраните её вместе с результатом нескольких проб: так будет проще оценить стоимость своего сценария. Для продолжения диалога история сообщений передаётся в последующих запросах; один API-ключ сам по себе не хранит контекст разговора.

Как работают рассуждения, JSON и инструменты

Режим рассуждений включён по умолчанию. Его можно контролировать параметром thinking, а глубину — reasoning_effort. Для сложной задачи имеет смысл сравнить режимы на одинаковых входных данных. Дополнительные рассуждения не заменяют проверку кода или фактов.

Совместимость формата не означает одинаковое действие каждого параметра у разных провайдеров. Например, документация DeepSeek указывает, что в режиме рассуждений temperature, presence_penalty и frequency_penalty не действуют, хотя их передача не вызывает ошибку.

Для JSON-ответа используется response_format: {"type": "json_object"}; инструкция должна явно просить JSON и описывать ожидаемые поля. Документация также предупреждает о возможном пустом содержимом. В приложении результат всё равно нужно разобрать и проверить: корректный JSON может содержать неверные сведения. Подробнее — в заметке о структурированном выводе модели.

Вызов инструментов позволяет модели предложить обращение к вашей функции, но выполняет её приложение. Если подключаете инструменты в режиме рассуждений, внимательно сверяйте правила передачи истории с документацией DeepSeek: требования к reasoning_content отличаются от обычного чата. Базовый механизм разобран в статье про tool calling.

Сколько стоит DeepSeek API

Модель оплачивается по входным и выходным токенам. Для повторно используемого входа возможна отдельная ставка попадания в кеш. Официальные цены на 19 октября приведены в долларах за миллион токенов:

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

Условный расчёт: 10 миллионов входных токенов без кеша и 1 миллион выходных у Flash вне часов пик стоят $2,10: $1,50 за вход и $0,60 за выход. В часы пик при тех же объёмах — $4,20. Это арифметический пример расхода модели, без других сервисов и условий оплаты.

Кеширование нельзя просто предположить для всего входа. Смотрите фактическую статистику и повторяемую часть запросов. Принцип экономии разобран в заметке о кешировании промптов.

Есть ли бесплатный DeepSeek API

У официального API опубликованы платные тарифы. Возможность пользоваться веб-чатом не делает вызовы из программы бесплатными. Если в кабинете есть предоставленный баланс или акция, ориентируйтесь на её действующие условия; постоянный бесплатный API из этого не следует.

Отдельно оплачиваются Search и Fetch — поиск и получение веб-страниц. В опубликованной таблице каждый сервис стоит $0,75 за 1000 успешных запросов. Временный бесплатный режим серверных инструментов в перечисленных интеграциях имеет собственные условия. Обновление модели и запуск этих сервисов разобраны в отдельной новости; не смешивайте их оплату с токенами модели.

Ошибки при подключении и ограничения

Не повторяйте бесконечно один и тот же запрос при неверном ключе или пустом балансе. Для временных ошибок нужны ограниченное число попыток и задержки. Общая схема описана в заметке про rate limit и ошибку 429.

По документации предел одновременных запросов для аккаунта составляет 2500 у Flash и 500 у V4 Pro. Это не обещание такой скорости генерации и не разрешённое количество запросов в секунду. Несколько ключей одного аккаунта не создают независимые квоты параллельности.

Для production-сценария сохраняйте имя модели, расход и длительность запроса, обрабатывайте тайм-ауты и проверяйте результат до публикации на сайте. Сравнивать провайдеров по одной цене недостаточно: качество и стоимость законченной задачи важнее. Подход к сравнению есть в материале о выборе API моделей.

Для старта достаточно одного короткого запроса с ограниченным ответом. Убедитесь, что авторизация работает, результат подходит по качеству, а статистика расхода понятна. После этого добавляйте историю, JSON и инструменты по одному — так проще увидеть, какое изменение повлияло на стоимость или поведение приложения.