Вы хотите, чтобы инструмент сам отправлял бриф нейросети и получал готовый черновик. 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:
- Вставьте код в Блокнот. В «Сохранить как» выберите тип «Все файлы», имя
first-deepseek-call.pyи кодировку UTF-8. Сохраните в отдельную учебную папку. - В Проводнике включите показ расширений файлов и проверьте полное имя: оно должно оканчиваться на
.py, а не.py.txt. - Откройте эту папку, в адресной строке Проводника введите
powershellи нажмите Enter. В открывшемся терминале запуститеpython first-deepseek-call.pyлибо команду Python, принятую в вашей среде. Если Python не найден, сначала установите его из официального источника или обратитесь к администратору.
Скрытый ввод ключа выполняйте в обычном терминале: не каждое встроенное окно поддерживает его корректно.
В готовом доверенном клиенте без написания кода нужен тот же смысл запроса: адрес DeepSeek, секрет, выбранная модель и учебный текст. До нажатия кнопки найдите настройку повторов и отключите её для первого теста. Если клиент не показывает служебный ответ и расход, для учёта потребуется кабинет поставщика.
Основные поля примера:
| Поле | Что делает |
|---|---|
messages | Передаёт текст задания с ролью пользователя |
model | Выбирает модель |
thinking | Явно задаёт режим для этого примера |
max_tokens | Ограничивает длину генерации, но не суммарный бюджет приложения |
stream: false | Возвращает ответ целиком, а не постепенно |
Authorization | Передаёт секрет для доступа; не выводится на экран |
Адрес и структура примера сверены с инструкцией первого вызова и спецификацией Chat Completions. В файле один вызов отправки, нет цикла, расписания или автоматического повтора.

Проверка первого вызова включает секрет, число отправок, содержимое ответа и расход. Автоматизацию подключайте после этой проверки.
Как понять, что запрос сработал
Успешная доставка ответа и качество текста — две отдельные проверки. В служебном результате смотрите содержимое choices, текст message.content, причину окончания finish_reason и статистику usage. Если указано length, генерация достигла ограничения и ответ может быть обрезан. Описание ответа API.
Редакционный пример подходящего текста: «Курс “Старт” стоит 3 000 рублей и начинается 2 ноября. Если хотите узнать программу, уточните детали у организатора». Программа курса не была предоставлена, поэтому перечислять уроки модель не должна. Это эталон проверки, не полученный ответ DeepSeek.
Проверьте цену, дату и отсутствие скидки. Если появились «первое занятие бесплатно» или гарантия результата, текст не принимается, даже когда запрос завершился успешно.
Сохраните дату, модель, служебный идентификатор запроса, расход и объём правки. Секрет и заголовок авторизации в журнал не записывайте. Для первого теста полезнее один полный ответ с понятной статистикой, чем поток текста, по которому вы не можете восстановить итоговый расход.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
300 ₽ на первые запросы
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Начислим при регистрации в Agent ROI.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
при регистрации
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Попробуйте Grok, ChatGPT,
Gemini, Claude и Perplexity
Эти модели доступны по одной подписке
в Agent ROI.
Начните с бонуса при регистрации.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
300 ₽ при регистрации
Карту привязывать не нужно.
Используйте эти модели в Agent ROI.
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Бонус начислим при регистрации.
Карту привязывать не нужно.
300 ₽ на первые запросы
Бонус при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.

Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту привязывать не нужно
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в 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-интеграцию проектируйте после того, как понятны качество результата и порядок контроля.
Больше материалов по теме — в разделе «ИИ-агенты, автоматизация и разработка».