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

Материал проверен 14 октября 2026 года. Реальный API-вызов не выполнялся, кабинет не открывался и ключ не создавался. Пример ответа, расхода и ставок ниже вымышленный; код проверяется офлайн и не служит подтверждением доступности или оплаты из конкретного аккаунта.

DeepSeek API: когда он нужен вместо чата

API — интерфейс, через который программа обращается к сервису. Например, внутренний инструмент получает три поля брифа, отправляет их модели и показывает менеджеру черновик письма. Человек по-прежнему проверяет факты, но ему не нужно каждый раз копировать данные в отдельный чат.

Для обычного ручного запроса достаточно доступного чата. Для статической страницы, которую ИИ помог написать, API тоже не требуется: готовый HTML может работать без нейросети. API становится нужен, когда посетитель или сотрудник должен получать новые ответы прямо внутри вашего приложения.

Различайте доступ к чату и запросы из программы. Цена посреднического сервиса может включать свою наценку, а расходы прямого API учитываются у провайдера. Не считайте бесплатность чата или оплату его подписки подтверждением оплаченного API-доступа. Обзор способов оплаты вынесен в статью о стоимости DeepSeek.

Если вам нужен только один черновик в неделю, сначала проверьте задачу вручную. Интеграция имеет смысл после того, как понятно, какие данные отправлять и по каким признакам принимать ответ.

Где получить API-ключ DeepSeek и как его хранить

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

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

В готовом API-клиенте обычно настраиваются адрес сервиса, секрет и модель. Вводите секрет только в доверенном локальном инструменте или серверной настройке. Прежде чем передавать DeepSeek API key стороннему приложению, выясните, где оно его хранит и кто может получить доступ.

Ключ нельзя размещать в HTML или JavaScript, который скачивает браузер посетителя. То, что строка не показана на странице, не делает её секретной: пользователь может посмотреть исходный код и сетевые запросы. Для сайта ключ хранится на сервере; схему разберём ниже.

Для первого теста используйте вымышленные сведения. Политика DeepSeek описывает получение ввода и файлов, а стороннее приложение имеет собственного оператора данных. Ключ доступа не решает вопрос допустимости загрузки клиентской информации. Политика от 10 февраля 2026.

Как выбрать модель и режим

По сентябрьскому журналу DeepSeek для Flash используется имя deepseek-flash, для Pro — deepseek-v4-pro. Старые Flash-имена временно направляются на новую модель. Проверяйте служебный список поставщика перед настройкой; старое название из tutorial не гарантирует прежнюю версию. Журнал изменений.

В запросе поле model выбирает вариант модели. Режим рассуждения настраивается отдельно. Для короткого письма в учебном примере он явно отключён: так проще увидеть полный ответ при небольшом ограничении длины. Это выбор для примера, а не рекомендация отключать рассуждение во всех рабочих сценариях.

Для проверки доступных имён используйте документацию или служебный endpoint списка моделей, а не вопрос самой модели «какая ты версия?». Ответ, написанный в разговоре, не является подтверждением маршрутизации. Справка списка моделей.

Публичный идентификатор может обновляться у поставщика. Запишите имя из запроса, поле модели в полученном ответе и дату. Это поможет разбирать изменения; полной гарантией неизменной внутренней версии такая запись не является. Критерии выбора рассмотрены в гайде о Pro и Flash.

Первый запрос: один файл и вымышленный бриф

Для воспроизведения примера нужны установленный Python 3, доступ к API из вашей среды и разрешённый вами расход в аккаунте. Ключ можно заранее задать как переменную окружения DEEPSEEK_API_KEY; если её нет, пример попросит скрытый ввод. Не вставляйте секрет прямо в файл.

Сохраните следующий код как first-deepseek-call.py. Здесь используется стандартная библиотека Python, дополнительных пакетов устанавливать не нужно. Запуск файла отправит один реальный платный запрос при наличии действующего ключа и условий доступа; в ходе подготовки статьи запуск с провайдером не выполнялся.

import getpass
import json
import os
import urllib.error
import urllib.request

key = os.environ.get("DEEPSEEK_API_KEY") or getpass.getpass(
    "API-ключ (ввод скрыт): "
)
if not key.strip():
    raise SystemExit("Ключ не задан; запрос не отправлен")

payload = {
    "model": "deepseek-flash",
    "messages": [{
        "role": "user",
        "content": (
            "Напиши письмо до 60 слов на русском. "
            "Учебный продукт: курс «Старт», цена 3000 рублей. "
            "Начало 2 ноября. Скидки не заявлены. "
            "Сохрани факты; не добавляй обещаний."
        )
    }],
    "thinking": {"type": "disabled"},
    "max_tokens": 300,
    "stream": False
}
request = urllib.request.Request(
    "https://api.deepseek.com/chat/completions",
    data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer " + key.strip()
    },
    method="POST"
)
try:
    with urllib.request.urlopen(request, timeout=60) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise SystemExit(f"HTTP {error.code}; автоматического повтора нет")
except urllib.error.URLError:
    raise SystemExit("Сетевая ошибка; автоматического повтора нет")

choice = result["choices"][0]
print(choice["message"].get("content", ""))
print("Модель:", result.get("model", "не указана"))
print("Завершение:", choice.get("finish_reason"))
print("Расход токенов:", result.get("usage", {}))

Для первой попытки в Windows:

  1. Вставьте код в Блокнот. В «Сохранить как» выберите тип «Все файлы», имя first-deepseek-call.py и кодировку UTF-8. Сохраните в отдельную учебную папку.
  2. В Проводнике включите показ расширений файлов и проверьте полное имя: оно должно оканчиваться на .py, а не .py.txt.
  3. Откройте эту папку, в адресной строке Проводника введите powershell и нажмите Enter. В открывшемся терминале запустите python first-deepseek-call.py либо команду Python, принятую в вашей среде. Если Python не найден, сначала установите его из официального источника или обратитесь к администратору.

Скрытый ввод ключа выполняйте в обычном терминале: не каждое встроенное окно поддерживает его корректно.

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

Основные поля примера:

ПолеЧто делает
messagesПередаёт текст задания с ролью пользователя
modelВыбирает модель
thinkingЯвно задаёт режим для этого примера
max_tokensОграничивает длину генерации, но не суммарный бюджет приложения
stream: falseВозвращает ответ целиком, а не постепенно
AuthorizationПередаёт секрет для доступа; не выводится на экран

Адрес и структура примера сверены с инструкцией первого вызова и спецификацией Chat Completions. В файле один вызов отправки, нет цикла, расписания или автоматического повтора.

Первый запрос DeepSeek API: защитить ключ, отправить один бриф, проверить ответ и сохранить расход

Проверка первого вызова включает секрет, число отправок, содержимое ответа и расход. Автоматизацию подключайте после этой проверки.

Как понять, что запрос сработал

Успешная доставка ответа и качество текста — две отдельные проверки. В служебном результате смотрите содержимое choices, текст message.content, причину окончания finish_reason и статистику usage. Если указано length, генерация достигла ограничения и ответ может быть обрезан. Описание ответа API.

Редакционный пример подходящего текста: «Курс “Старт” стоит 3 000 рублей и начинается 2 ноября. Если хотите узнать программу, уточните детали у организатора». Программа курса не была предоставлена, поэтому перечислять уроки модель не должна. Это эталон проверки, не полученный ответ DeepSeek.

Проверьте цену, дату и отсутствие скидки. Если появились «первое занятие бесплатно» или гарантия результата, текст не принимается, даже когда запрос завершился успешно.

Сохраните дату, модель, служебный идентификатор запроса, расход и объём правки. Секрет и заголовок авторизации в журнал не записывайте. Для первого теста полезнее один полный ответ с понятной статистикой, чем поток текста, по которому вы не можете восстановить итоговый расход.

Agent ROI

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке

Используйте эти модели
в Agent ROI.

Подписку можно оплатить в рублях.

Стоимость DeepSeek API: как считать одну задачу

Токены — фрагменты, на которые модель разбивает текст. Они не равны русским словам или страницам. Считайте по статистике ответа, а до запуска используйте оценку с запасом. В расход входят передаваемая история и инструкции, поэтому длинный диалог может быть дороже короткого одиночного задания. Учёт токенов.

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

Для простого расчёта без кэша:

Стоимость = входные токены / 1 000 000 × ставка входа
          + выходные токены / 1 000 000 × ставка выхода

Учебный расчёт с вымышленными ставками: вход — 1 000 токенов, выход — 200; входная ставка — 1 доллар за миллион, выходная — 2 доллара за миллион. Тогда задача стоит 0,001 + 0,0004 = 0,0014 доллара, а сто одинаковых запусков — 0,14 доллара. Это пример арифметики, не тариф DeepSeek и не прогноз вашего счёта.

Если вход частично попал в кэш, считайте обработанные части по своим ставкам. Не закладывайте весь вход по более дешёвой цене заранее. После теста сверяйте usage и детализацию расходов в кабинете; разницу до и после по общему балансу удобно использовать только при отсутствии параллельной работы. Дополнительно учитывайте услуги вашего инструмента и стоимость ручной проверки.

Что проверить при ошибке

Не запускайте запрос многократно без выяснения причины. В примере выводится HTTP-код; по нему и деталям ошибки в доверенном инструменте можно проверить авторизацию, формат, баланс и состояние сервиса.

СитуацияСледующее действие
HTTP 401 — ошибка авторизацииПроверить источник ключа и отсутствие пробелов; при сомнении создать новый ключ через кабинет
HTTP 400 / 422 — формат или параметрыСверить имя модели и поля с документацией; причину уточнить по сообщению сервиса
HTTP 402 — недостаточно средствПроверить баланс и правила использования, прежде чем повторять
HTTP 429 — ограничение запросовОстановить параллельные отправки и проверить ограничения своего инструмента
HTTP 500 / 503 — ошибка или перегрузка сервисаПроверить состояние сервиса и согласовать один повтор после паузы
Сетевой timeoutПроверить кабинет и журнал; отсутствие ответа не доказывает, что работа не началась

Соответствие кодов сверено с таблицей ошибок DeepSeek. Для подробной причины смотрите сообщение ошибки в доверенном клиенте или серверном журнале, в котором отключена запись заголовка авторизации. Учебный файл выводит только код, чтобы случайно не раскрыть лишние данные.

Последняя ситуация важна: повтор может стать вторым платным обращением. После сбоя сначала выясните состояние первого запроса. В учебном файле повторы отсутствуют, а для рабочей системы их число, паузы и условия должен определить разработчик.

Как ограничить расходы и отозвать ключ

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

Перед интеграцией предусмотрите ограничения числа запросов на пользователя, размера текста, длины ответа и суммарного расхода за период. Добавьте понятный выключатель отправки. Если кабинет предлагает финансовые лимиты и уведомления, настройте их отдельно; не предполагайте наличие такой функции только по названию провайдера.

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

Как подключить API к сайту через сервер

Рекомендуемая схема:

Браузер → ваш сервер → DeepSeek API
Браузер ← проверенный ответ ← ваш сервер
Ключ хранится только на сервере.

Браузер отправляет пользовательский бриф вашему серверу. Сервер проверяет пользователя, длину и допустимость данных, применяет лимиты, формирует запрос и передаёт результат обратно. Сам секрет браузер не получает.

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

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

FAQ

Нужно ли уметь программировать для API?

Можно использовать доверенный совместимый клиент. Пользователь или администратор должен настроить адрес, ключ, модель, учёт и ограничения; для своего сайта потребуется серверная реализация.

Если спрятать ключ в JavaScript, он станет безопасным?

Файл и запросы доступны браузеру пользователя. Храните секрет на сервере, а не в клиентской странице.

Один запрос всегда стоит одинаково?

Расход зависит от входа, ответа, модели и применяемой ставки. Повторы и история меняют объём работы.

Можно ограничиться max_tokens?

Этот параметр ограничивает генерацию одного обращения. Число запросов, вход и бюджет периода нужно контролировать отдельно.

Следующий шаг для команды

Подготовьте один вымышленный бриф, заранее выберите допустимый расход и выполните один запрос в доверенном инструменте. Сохраните ответ, статистику и условия приёмки. Для ручной проверки задачи можно начать с доступной модели в Agent Roi; отдельную API-интеграцию проектируйте после того, как понятны качество результата и порядок контроля.

Больше материалов по теме — в разделе «ИИ-агенты, автоматизация и разработка».