DeepSeek API key: как получить ключ и какой base_url указать
Два пути к ключу DeepSeek: официальная платформа и шлюз Zukko. Разбираем адреса API, имена моделей, проверку ключа и частые ошибки подключения.
5 мин · · API-ключи · модели
DeepSeek API key нужен, чтобы вызывать модели DeepSeek из кода, редактора или чат-клиента. Ключ можно получить двумя путями: на официальной платформе DeepSeek или через API-шлюз, где один ключ работает сразу для нескольких вендоров. Ниже — что делать в каждом случае, какой base_url и какое имя модели указывать, как за минуту проверить, что ключ рабочий, и как не перепутать адреса.
Путь 1. Ключ на официальной платформе DeepSeek
Порядок такой, как у большинства API-платформ:
- Зарегистрируйтесь на платформе DeepSeek (platform.deepseek.com) и войдите в личный кабинет.
- Пополните баланс. В документации DeepSeek ошибка 402 расшифрована как «закончился баланс», решение — страница пополнения.
- Создайте ключ в разделе API-ключей кабинета и сохраните его в менеджере паролей или переменной окружения.
Названия пунктов меню и способы регистрации и оплаты определяет сама платформа и может менять, поэтому сверяйтесь с тем, что видите на сайте. Если вы в России и официальный путь не подходит, ниже описан второй вариант — через шлюз.
Официальные параметры по документации DeepSeek на момент написания:
| Параметр | Значение |
|---|---|
base_url (формат OpenAI) | https://api.deepseek.com |
base_url (формат Anthropic) | https://api.deepseek.com/anthropic |
| Эндпоинт чата | https://api.deepseek.com/chat/completions |
| Имена моделей | deepseek-flash, deepseek-v4-pro |
| Контекст | 1M токенов |
Обратите внимание: официальный адрес без суффикса /v1, а имя быстрой модели — deepseek-flash. В документации также сказано, что прежние имена моделей ещё принимаются, но обслуживаются новой моделью. Цены у DeepSeek зависят от времени суток (есть пиковый и непиковый тариф), актуальную таблицу смотрите на странице цен документации.
Путь 2. Ключ DeepSeek через шлюз Zukko
Если нужен доступ из России с оплатой СБП, картой MasterCard или криптой, или хочется использовать DeepSeek и Claude, GPT, Gemini, Qwen и GLM на одном балансе, подойдёт шлюз. Это не официальный сервис DeepSeek: вы работаете со своим ключом Zukko и адресом Zukko.
- Зарегистрируйтесь в кабинете Zukko и пополните баланс от $1.
- На странице API-ключей создайте ключ. Он выглядит как
fetch_...и показывается один раз, скопируйте его сразу. - При желании задайте ключу дневной и месячный лимит в долларах и список разрешённых моделей.
Параметры подключения:
| Параметр | Значение |
|---|---|
base_url (формат OpenAI) | https://api.zukko.pro/v1 |
| Эндпоинт чата | https://api.zukko.pro/v1/chat/completions |
| Авторизация | Authorization: Bearer fetch_... |
| Модели DeepSeek | deepseek-v4.1-flash, deepseek-v4-pro |
Список моделей всегда доступен запросом GET https://api.zukko.pro/v1/models (см. документацию по моделям). Ключ передаётся в заголовке Authorization: Bearer; Anthropic SDK шлёт его в x-api-key, это тоже работает.
Какие адреса и имена модели не смешивать
Самая частая ошибка — взять base_url из одного места, а имя модели из другого.
| Вы используете | base_url | Имя модели |
|---|---|---|
| Ключ с платформы DeepSeek | https://api.deepseek.com | deepseek-flash |
| Ключ Zukko | https://api.zukko.pro/v1 | deepseek-v4.1-flash |
Ключ одной системы не подойдёт к адресу другой: в ответ придёт 401. Имя модели из чужой документации даст ошибку model_not_found (404).
Как проверить, что ключ работает
Сначала проверьте ключ запросом баланса. Он не тратит токены, а неверный ключ сразу даст 401 (список моделей для этого не подходит: он открыт и ключ не проверяет):
curl https://api.zukko.pro/v1/balance \
-H "Authorization: Bearer $ZUKKO_API_KEY"Затем отправьте короткий запрос к модели:
curl https://api.zukko.pro/v1/chat/completions \
-H "Authorization: Bearer $ZUKKO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [{"role": "user", "content": "Ответь одним словом: работает"}]
}'То же на Python с официальной библиотекой openai:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.zukko.pro/v1",
api_key=os.environ["ZUKKO_API_KEY"],
)
response = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[{"role": "user", "content": "Ответь одним словом: работает"}],
)
print(response.choices[0].message.content)
print(response.usage)Для официальной платформы меняются только base_url="https://api.deepseek.com", ключ и имя модели deepseek-flash. Ключ держите в переменной окружения, а не в коде: см. безопасное хранение API-ключей. Если ключ всё-таки попал в публичный репозиторий, сразу отзовите его и создайте новый.
Что значат ошибки
| Код | Причина | Что делать |
|---|---|---|
| 401 | неверный или обрезанный ключ, либо ключ не к тому адресу | скопировать ключ целиком, проверить base_url |
| 402 | закончился баланс | пополнить баланс на той системе, чей ключ используете |
403 model_not_allowed_for_key (Zukko) | модели нет в списке ключа | добавить модель в настройках ключа |
404 model_not_found (Zukko) | неизвестное имя модели | взять имя из GET /v1/models |
| 429 | лимит ключа или ограничение у провайдера | подождать, снизить частоту, проверить лимиты ключа |
| 503 | провайдер недоступен или модель выключена | повторить позже или взять другую модель |
Разбор 401 подробнее — в статье ошибка 401 Invalid API key.
Сколько это стоит
Цены за 1M токенов на 18 октября 2026 (вход / выход):
| Модель | Zukko | Официальная цена | Контекст | Индекс силы |
|---|---|---|---|---|
deepseek-v4.1-flash | 0.013 / 0.038 | 0.15 / 0.6 | 1M | 39 |
deepseek-v4-pro | 0.075 / 0.225 | 0.66 / 1.98 | 1M | 36 |
Официальные цены в таблице соответствуют непиковому тарифу DeepSeek; в пиковые часы у самой платформы они выше, сверяйтесь с её страницей цен.
Пример: 1 000 запросов по 2 000 токенов входа и 500 выхода, то есть 2M входа и 0.5M выхода. На deepseek-v4.1-flash в Zukko: 2 × $0.013 + 0.5 × $0.038 = $0.026 + $0.019 = $0.045. По официальным ценам из таблицы: 2 × $0.15 + 0.5 × $0.6 = $0.60. На deepseek-v4-pro в Zukko: 2 × $0.075 + 0.5 × $0.225 = $0.2625, по официальным: 2 × $0.66 + 0.5 × $1.98 = $2.31. У моделей DeepSeek в Zukko чтение кэша стоит как вход, поэтому считайте весь вход по цене входа. Индекс силы — Intelligence Index от Artificial Analysis; подойдёт ли модель вашей задаче, проверьте на своих примерах. Подробнее о самой дешёвой модели — в статье DeepSeek V4.1 Flash через API.
Пополнение через СБП: платёжная страница добавляет 8,5% сверху, на баланс зачисляется выставленная сумма в долларах. Есть также криптовалюта и карты MasterCard (комиссия около 13%, суммы $2–$594).
Частые вопросы
Где взять DeepSeek API key бесплатно?
Мы не обещаем бесплатный доступ. Условия официальной платформы (включая возможное стартовое начисление) определяет сама платформа и они меняются: проверяйте на её сайте. За саму регистрацию в Zukko ничего не начисляется; есть $0.50 за подписку на канал @zukkopro, один раз на Telegram-аккаунт.
Какой DeepSeek API URL указывать?
Для официальной платформы https://api.deepseek.com (OpenAI-формат) или https://api.deepseek.com/anthropic (Anthropic-формат). Для ключа Zukko — https://api.zukko.pro/v1.
Можно ли использовать один ключ для чата и для кода?
Да. Ключ Zukko работает в OpenAI- и Anthropic-форматах и подходит для редакторов, SDK и скриптов. Какой формат выбрать, зависит от инструмента: клиенты на OpenAI SDK работают с /v1/chat/completions, Claude Code и Anthropic SDK — с /v1/messages.
Как узнать, какие модели DeepSeek доступны сейчас?
Вызовите GET /v1/models или откройте страницу «Модели» в кабинете: набор и цены меняются.
Чтобы получить ключ Zukko, откройте страницу API-ключей.
zukko
Платите в 25×
меньше
за Claude Code & ChatGPT
Один ключ fetch_* и base URL api.zukko.pro — в Cursor, Claude Code, Codex и любом SDK.
Похожие статьи
- xAI Grok API: подключение Grok 4.7, цена и контекст 256KКак вызвать grok-4.7 через OpenAI-совместимый API, что делать с лимитом контекста 256K и сколько стоят типичные запросы. Плюс сравнение с Grok 4.6.
- Grok API из России: как подключить без зарубежной картыПошагово подключаем Grok 4.7, 4.6 и 4.5 через шлюз: ключ, адрес, первый запрос на curl и Python, стриминг, картинки и оплата по СБП или в крипте.
- Claude Sonnet 5.5 через API: подключение, цены и кэш на 18 октября 2026Как вызвать claude-sonnet-5-5 из Python и curl, сколько стоит типичный запрос с кэшем и без и чем модель отличается от Sonnet 5 и Sonnet 4.6.
- Claude на Android в России: что делать, если приложение не ставитсяЕсли официальное приложение Claude не ставится на Android в России, пользоваться моделью с телефона всё равно можно: через веб-чат шлюза или клиент на своём ключе.