Один ключ к DeepSeek, GPT, Claude и Gemini — оплата в рублях, доступ без VPN.

Получить ключ

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 (если планируете писать код).

Добавьте ключ в переменную окружения:

bash
# 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 — его можно выполнить из любого терминала без установки дополнительных библиотек:

bash
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
  }'

Ожидаемый ответ (сокращён):

json
{
  "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. Установите его:

bash
pip install openai

Самый простой скрипт с использованием SDK:

python
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 API (по данным официальной документации)
Модель Контекст Особенности Для каких задач
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 раз дешевле.
Цены за 1M токенов (USD), вне пика / в пик
Модель Ввод (кэш-мисс) Ввод (кэш-хит) Вывод
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. Вот что можно изучить дальше:

Частые вопросы

Можно ли использовать 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-режим.

Один ключ вместо пяти аккаунтов

DeepSeek, GPT, Claude и Gemini через один OpenAI-совместимый адрес: api.aitunnel.ru/v1. Регистрация занимает пару минут, оплата в рублях, доступ без VPN.

  • Один ключ на все модели
  • Оплата в рублях и счёт для юрлиц
  • Совместимо с OpenAI SDK