DeepSeek API для начинающих: от ключа до первого запроса
Пошаговое руководство для тех, кто впервые работает с DeepSeek API. Никакой теории — только практика: получаем ключ, пишем первый запрос, разбираем ответ, считаем стоимость. Все примеры можно скопировать и запустить.
1. Получаем API-ключ
У DeepSeek API есть два официальных пути получить ключ, и один неофициальный, но удобный для России.
Официальный канал
Регистрируетесь на сайте platform.deepseek.com, создаёте API-ключ в разделе «API Keys». Ключ выглядит как sk-.... Этот способ требует зарубежной платёжной карты для пополнения баланса.
Через агрегатор (для России)
Если у вас нет зарубежной карты, используйте AITUNNEL: регистрация по email или Telegram, пополнение рублями от 500 ₽, ключ вида sk-aitunnel-.... Адрес API: https://api.aitunnel.ru/v1. Подробнее — в обзоре AITUNNEL.
Получить ключ DeepSeek за пару минут
Регистрация по email, оплата в рублях, доступ без VPN. Один ключ для DeepSeek, GPT, Claude и Gemini.
2. Настраиваем окружение
Для отправки запросов к DeepSeek API вам понадобится:
- API-ключ — сохраните его в переменную окружения, а не в код.
- HTTP-клиент — curl (есть в любой ОС) или Python с библиотекой openai (если планируете писать код).
Добавьте ключ в переменную окружения:
# Linux / macOS
export DEEPSEEK_API_KEY="sk-..."
# Windows (PowerShell)
$env:DEEPSEEK_API_KEY="sk-..."
# Windows (CMD)
set DEEPSEEK_API_KEY=sk-...
3. Первый запрос через cURL
Это минимальный запрос к DeepSeek API — его можно выполнить из любого терминала без установки дополнительных библиотек:
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": "Привет! Расскажи о себе в одном предложении."}
],
"stream": false
}'
Ожидаемый ответ (сокращён):
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": 1732012345,
"model": "deepseek-flash",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Привет! Я DeepSeek — языковая модель, созданная для помощи с вопросами, задачами и генерацией текста."
}
}
],
"usage": {
"prompt_tokens": 18,
"completion_tokens": 28,
"total_tokens": 46,
"prompt_cache_hit_tokens": 0,
"prompt_cache_miss_tokens": 18
}
}
Ключевые поля в ответе:
choices[0].message.content— текст ответа модели.usage.prompt_tokens— токенов в запросе.usage.completion_tokens— токенов в ответе.usage.prompt_cache_hit_tokens— сколько токенов запроса попали в кэш (подробнее — в статье про кэш ввода).
4. Запрос на Python с OpenAI SDK
DeepSeek API полностью совместим с форматом OpenAI Chat Completions, поэтому вы можете использовать официальный пакет openai для Python. Установите его:
pip install openai
Самый простой скрипт с использованием SDK:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
response = client.chat.completions.create(
model="deepseek-flash",
messages=[
{"role": "system", "content": "Отвечай кратко и по делу."},
{"role": "user", "content": "Сколько будет 2 + 2?"},
],
)
print(response.choices[0].message.content)
print(f"Токенов: {response.usage.total_tokens}")
Полные разборы примеров для разных языков — в разделе примеров кода.
5. Какие модели доступны
На момент октября 2026 года у DeepSeek две актуальные модели:
| Модель | Контекст | Особенности | Для каких задач |
|---|---|---|---|
deepseek-flash (DeepSeek-V4.1-Flash) |
1M токенов | Быстрая, дешёвая, поддержка инструментов и vision | Чат-боты, обработка текста, RAG, классификация |
deepseek-v4-pro (DeepSeek-V4-Pro-0813) |
1M токенов | Флагманская, глубокие рассуждения, сложный код | Аналитика, генерация кода, сложные рассуждения |
Рекомендация для новичков: начинайте с deepseek-flash. Он справляется с 90% задач, а стоит в разы дешевле. Переходите на deepseek-v4-pro только если модель flash не справляется.
Подробное сравнение — в статье deepseek-flash или deepseek-v4-pro: что выбрать.
6. Сколько это стоит
DeepSeek API работает по модели pay-as-you-go: вы платите только за потреблённые токены. Цена зависит от трёх факторов:
- Модели — flash дешевле, v4-pro дороже.
- Часов пик — по будням в 04:00–07:00 и 09:00–13:00 МСК цена вдвое выше.
- Кэша ввода — повторяющиеся префиксы запроса считаются до 50 раз дешевле.
| Модель | Ввод (кэш-мисс) | Ввод (кэш-хит) | Вывод |
|---|---|---|---|
deepseek-flash |
$0.15 – $0.30 | $0.003 – $0.006 | $0.60 – $1.20 |
deepseek-v4-pro |
$0.66 – $1.32 | $0.022 – $0.044 | $1.98 – $3.96 |
Для примера: один диалог из 10 сообщений (примерно 2 000 токенов ввода и 500 токенов вывода) на deepseek-flash вне пика будет стоить около $0.0006. С кэшированием system prompt — ещё дешевле.
Детальный разбор тарифов и примеры расчёта — на странице «Цены и расчёт».
7. Если что-то пошло не так
Вот самые частые проблемы у начинающих:
| Ошибка | Причина | Решение |
|---|---|---|
HTTP 401 — Unauthorized |
Неверный или отсутствующий API-ключ | Проверьте, что ключ передан в заголовке Authorization: Bearer и начинается с sk- |
HTTP 400 — Bad Request |
Некорректное тело запроса | Проверьте JSON-синтаксис, наличие поля model и правильный формат messages |
HTTP 429 — Too Many Requests |
Слишком частые запросы | Добавьте задержку между запросами (минимум 100 мс) |
| { "error": "insufficient_quota" } | Недостаточно средств на балансе | Пополните баланс в личном кабинете |
| Пустой ответ от модели | Слишком малый max_tokens |
Увеличьте max_tokens — для рассуждений нужно минимум 50 000 |
| Модель не найдена | Неправильное имя модели | Используйте deepseek-flash или deepseek-v4-pro |
Полный список ошибок с кодами — в разделе «Ошибки и лимиты».
Что дальше
Вы прошли путь от нуля до рабочего запроса к DeepSeek API. Вот что можно изучить дальше:
- Стриминг, JSON-режим и вызов инструментов на Python
- Режим рассуждений (thinking mode)
- Кэш ввода: как платить в 50 раз меньше
- Какую модель выбрать: flash или v4-pro
- Как сэкономить на токенах: 7 приёмов
Частые вопросы
Можно ли использовать DeepSeek API бесплатно
Нет, DeepSeek не предоставляет бесплатных кредитов для API. Каждый запрос тарифицируется. Однако благодаря низким ценам (от $0.15 за 1M токенов) и кэшированию ввода стоимость одного запроса часто составляет доли цента.
Нужен ли VPN для DeepSeek API
Нет, API-эндпоинт api.deepseek.com доступен из России напрямую. VPN может понадобиться только для регистрации аккаунта на platform.deepseek.com, если ваш IP блокируется — но это бывает не у всех провайдеров.
Чем DeepSeek API отличается от сайта chat.deepseek.com
Chat.deepseek.com — это веб-интерфейс для общения с моделью. API — это HTTP-интерфейс для программ. Через API вы можете отправлять запросы из своего кода, обрабатывать ответы, использовать стриминг, вызов инструментов и JSON-режим.
Ещё по теме
- Ошибки API-ключа DeepSeek: 401, 402, 403 Почему не работает ключ DeepSeek, как проверить и исправить ошибки.
- Быстрый старт: первый запрос к DeepSeek API Ключ, адрес, минимальный запрос и разбор ответа за пять минут.
- Ошибки и лимиты Коды ошибок, лимиты и способы их обойти.
- Подключение через AITUNNEL Один ключ, оплата в рублях, OpenAI- и Anthropic-совместимые адреса.