DeepSeek API: как получить ключ и подключить из России

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

Что такое DeepSeek API и зачем он нужен

В чате вы задаёте вопрос руками. Через API вопрос задаёт программа: сотня карточек товаров переписывается за минуту, телеграм-бот отвечает клиентам, скрипт разбирает входящие письма, редактор кода дописывает функции. DeepSeek ценят за сильный код и математику при низкой цене запроса — поэтому его часто берут именно для автоматизации, где запросов много. Что умеет актуальная модель, разобрано в статье «DeepSeek V4: что умеют Pro и Flash».

Для работы нужны три вещи: адрес API, ключ и имя модели. Ключ — это секретная строка, по которой сервис узнаёт, с чьего баланса списывать деньги. Подробно про ключи и их хранение — в гайде «API key: что такое API-ключ и как его получить».

Как получить DeepSeek API key на официальной платформе

1. Откройте платформу для разработчиков DeepSeek (platform.deepseek.com) и зарегистрируйтесь по почте.
2. В разделе API keys нажмите «Create new API key» и дайте ключу имя.
3. Скопируйте ключ сразу: полностью его показывают один раз.
4. Пополните баланс в разделе Top up — без денег на счёте запросы возвращают ошибку.

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

Где взять API DeepSeek из России: сравнение

Если вы уже платите за API в долларах и это удобно — берите платформу DeepSeek напрямую. Если нужна оплата российской картой или несколько моделей на одном ключе, проще агрегатор. Как устроены зарубежные роутеры и чем они неудобны из России — в статье «OpenRouter: как пользоваться».

Как подключить DeepSeek API через Умку

1. Зарегистрируйтесь — карта не нужна, на счёт сразу приходит 60 токенов.
2. В кабинете создайте ключ и задайте ему дневной лимит расхода.
3. Сохраните ключ в переменную окружения или файл .env, а не в код.
4. Укажите адрес https://umka.chat/v1 и модель deepseek/deepseek-v4-pro.

Пример на Python с официальной библиотекой OpenAI:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["UMKA_API_KEY"], base_url="https://umka.chat/v1")
r = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "Отвечай кратко, по-русски."},
        {"role": "user", "content": "Напиши функцию на Python, которая проверяет ИНН."},
    ],
)
print(r.choices[0].message.content)

То же самое через curl — удобно, чтобы проверить ключ без кода:

curl https://umka.chat/v1/chat/completions \
  -H "Authorization: Bearer $UMKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-v4-pro","messages":[{"role":"user","content":"Привет"}]}'

Если у вас уже есть код под официальный DeepSeek API, меняются две строки: base_url и api_key, плюс имя модели с префиксом deepseek/. Список всех доступных моделей возвращает запрос GET /v1/models с вашим ключом. Так же ключ подставляется в Cursor, Continue, n8n и другие инструменты, которые умеют работать с OpenAI-совместимым API.

Частые ошибки при подключении

• 401 Unauthorized. Ключ не передан или передан без слова Bearer в заголовке. Проверьте, что переменная окружения действительно читается.
• Модель не найдена. Имя написано без префикса поставщика или с опечаткой. Сверьтесь со списком из /v1/models.
• Ошибка баланса. Закончились токены или сработал дневной лимит ключа — это защита, а не сбой.
• Ключ в репозитории. Самая дорогая ошибка: публичный ключ находят боты за минуты. Если ключ утёк — удалите его в кабинете и создайте новый.

Сколько стоит DeepSeek API в рублях

Сам ключ бесплатный — платите за запросы, с того же баланса, что и в чате. Подписки нет, неиспользованные токены не сгорают. Ориентиры по публичным меркам Умки: ответ умной модели — около 33 токенов, быстрой — 1 токен. Реальное списание зависит от длины запроса и ответа: короткий вопрос дешевле, разбор большого файла дороже.

Пакеты: 290 ₽ — 725 токенов (около 0,40 ₽ за токен), 690 ₽ — 1 811, 1 490 ₽ — 4 172, 3 900 ₽ — 11 700 (около 0,33 ₽ за токен). На стартовом пакете это примерно 20 ответов умной модели — хватит, чтобы проверить интеграцию и прогнать бота на тестовых данных. Если задача — код, посмотрите также страницу нейросетей для кода и статью «ИИ для кода»: для части задач DeepSeek выгоднее, для части — Claude.

Вывод

DeepSeek API подключается так же просто, как OpenAI: адрес, ключ, имя модели. Из России упирается всё не в технику, а в оплату. Если у вас есть зарубежная карта — берите ключ на платформе DeepSeek. Если нет — подключайтесь через агрегатор с рублёвой оплатой и меняйте в коде две строки. А попробовать модель руками до написания кода можно на странице DeepSeek на русском.

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