Инструкции

DeepSeek API: как получить ключ, выбрать модель и рассчитать оплату

Для официального DeepSeek API нужен ключ DeepSeek и OpenAI-совместимый клиент. В проверенном примере используются адрес https://api.deepseek.com, переменная окружения DEEPSEEK_API_KEY и официальное имя модели deepseek-flash. Документация DeepSeek также описывает Anthropic-совместимый адрес https://api.deepseek.com/anthropic — официальная документация.

Если запрос «deepseek api купить» означает доступ через Zenith, это другой маршрут: ключ Zenith выдают через Telegram-бота, а пополнение относится к внутреннему балансу Zenith и цифровому доступу внутри сервиса, а не к личному балансу DeepSeek. Ниже разделены официальный API, каталог Zenith, семь его SKU и расчёт для одинакового объёма токенов.

Что нужно для доступа к DeepSeek API

Официальная документация подтверждает формат запроса, адрес API и использование ключа через переменную окружения. В предоставленных материалах DeepSeek не описаны конкретная последовательность создания ключа, способы пополнения из России, доступность банковских карт, комиссии или НДС. Поэтому нельзя достоверно обещать завершённую покупку официального баланса DeepSeek по определённому платёжному сценарию.

После получения ключа в интерфейсе DeepSeek сохраните его как секрет и передайте SDK через DEEPSEEK_API_KEY. Не вставляйте ключ в браузерный код, репозиторий, логи или чужую форму. Для Zenith используйте отдельную переменную ZENITH_API_KEY и отправляйте её только на https://api.zenithmarket.dev.

В документации Zenith указаны канал выдачи API-ключа — Telegram-бот — и OpenAI-совместимый адрес https://api.zenithmarket.dev/v1. Способы оплаты отображаются перед созданием счёта. Итоговая сумма и комиссия показываются до или во время оплаты в зависимости от платёжного канала — условия Zenith.

Официальные модели, алиасы и датированные версии

В официальной таблице DeepSeek имя deepseek-flash связано с версией DeepSeek-V4.1-Flash-1017. Имена deepseek-v4-flash и deepseek-v4-flash-vision-exp ещё принимаются как старые имена, но выведенные версии обслуживаются той же DeepSeek-V4.1-Flash-1017 по тарифу Flash. Это правило официального API не доказывает, что одноимённый SKU Zenith имеет тот же маршрут.

Для Pro официальная таблица связывает вызываемое имя deepseek-v4-pro с DeepSeek-V4-Pro-0813. Имена deepseek-v4.1-flash и deepseek-v4.1-flash-1017 в проверенной официальной документации не подтверждены как вызываемые имена API. Не следует заменять ими документированное deepseek-flash без отдельного подтверждения.

SKU каталога Zenith Что подтверждено Цена, вход/выход за 1M токенов
deepseek-v4-pro-0813 Название совпадает с официальной версией, но маршрут SKU Zenith отдельно не подтверждён. $0,135 / $0,400
deepseek-v4-pro Официальное имя связано с DeepSeek-V4-Pro-0813; соответствие маршрута Zenith не доказано. $0,135 / $0,400
deepseek-v4.1-flash-1017 Название версии, на которую направляется официальный deepseek-flash; вызываемое официальное имя не подтверждено. $0,060 / $0,240
deepseek-v4.1-flash Официальное вызываемое имя не подтверждено. $0,060 / $0,240
deepseek-v4-flash-0731 В проверенных официальных источниках соответствие upstream неизвестно. $0,030 / $0,120
deepseek-v4-flash Официальное legacy-имя перенаправляется на V4.1-Flash-1017, но маршрут SKU Zenith не подтверждён. $0,030 / $0,120
deepseek-v4-flash-vision-exp Официальное legacy-имя также обслуживается V4.1-Flash-1017; маршрут Zenith не подтверждён. $0,060 / $0,240

Каталог Zenith от 27 октября 2026 года подтверждает наличие этих идентификаторов, цены и поддерживаемые endpoints chat_completions и responses, но не превращает семь строк в семь разных базовых моделей. Для проверки перед запросом выполните:

curl https://api.zenithmarket.dev/v1/models \
  -H "Authorization: Bearer $ZENITH_API_KEY"

Найдите в JSON нужный id и проверьте supported_endpoint_types. Если в записи нет признака Vision или reasoning, это подтверждает только отсутствие такого поля в ответе, но не доказывает отсутствие или наличие соответствующей возможности модели. Доступность и цены каталога нужно сверять с текущим ответом API или карточкой модели — документация протокола Zenith.

Как выбрать Flash или Pro

В официальной таблице для актуальных Flash и Pro указаны контекст до 1M токенов, максимальный вывод до 384K токенов и режим размышления по умолчанию. У Flash отдельно указана поддержка Vision, у Pro — отсутствие Vision. Ограничение параллельности также различается: 2500 для Flash и 500 для Pro. Эти параметры помогают выбрать маршрут по типу входа и нагрузке, но не доказывают сравнительное качество ответов.

Дополнительные профили с примерами входа и ожидаемым форматом результата: DeepSeek V4 Pro, V4.1 Flash и 1017, V4 Flash, 0731 и vision-exp.

Расчёт оплаты для одного сценария

Возьмём сценарий: 4000 входных и 800 выходных токенов, без кэша, комиссий и внешних инструментов. Формула: 4000 × input_price / 1 000 000 + 800 × output_price / 1 000 000. Для deepseek-v4.1-flash-1017 по прайсу Zenith: 4000 × 0,06 / 1 000 000 + 800 × 0,24 / 1 000 000 = $0,000432; 10 000 таких обращений дают $4,32.

SKU Zenith Один запрос 10 000 запросов
deepseek-v4-pro-0813 $0,00086 $8,60
deepseek-v4-pro $0,00086 $8,60
deepseek-v4.1-flash-1017 $0,000432 $4,32
deepseek-v4.1-flash $0,000432 $4,32
deepseek-v4-flash-0731 $0,000216 $2,16
deepseek-v4-flash $0,000216 $2,16
deepseek-v4-flash-vision-exp $0,000432 $4,32

Это арифметический пример по прайсу Zenith, переданному Comrad404 27 октября 2026 года и сверенному со снимком каталога. Он не является независимо подтверждённым действующим тарифом и не сравнивает качество моделей. Фактическая сумма зависит от числа токенов, кэша и условий сервиса. Для официального API ставки Flash и Pro нужно считать по официальной таблице DeepSeek, где отдельно указаны cache hit, cache miss, вход, выход и peak/off-peak.

Ключ и первый официальный запрос

Ниже — воспроизводимый пример для официального OpenAI-совместимого API. Он не использует ключ Zenith. Секрет передаётся через окружение:

  1. Сохраните следующий код в first_request.py и запустите python first_request.py.
export DEEPSEEK_API_KEY="ваш_ключ_DeepSeek"
python -m pip install openai
python first_request.py
import os
from openai import OpenAI

api_key = os.environ.get("DEEPSEEK_API_KEY")
if not api_key:
    raise SystemExit("Задайте DEEPSEEK_API_KEY")

client = OpenAI(
    api_key=api_key,
    base_url="https://api.deepseek.com",
)

try:
    response = client.chat.completions.create(
        model="deepseek-flash",
        messages=[
            {"role": "system", "content": "Отвечай кратко и по-русски."},
            {"role": "user", "content": "Назови три шага проверки API-ответа."}
        ],
        stream=False,
        reasoning_effort="high",
        extra_body={"thinking": {"type": "enabled"}}
    )
    print(response.choices[0].message.content)
except Exception as exc:
    raise SystemExit(f"Запрос не завершился успешно: {exc}")

Иллюстрация ожидаемого формата ответа — напечатанный текст ассистента, например нумерованный список из трёх пунктов. Это не результат реально выполненного теста.

Разбор ошибки до отправки запроса

Если команда завершилась сообщением Задайте DEEPSEEK_API_KEY, причина локальная: переменная окружения отсутствует, поэтому программа остановилась до HTTP-запроса. Выполните команду export DEEPSEEK_API_KEY="ваш_ключ_DeepSeek" в том же терминале и снова запустите файл. Ожидаемый результат — переход к вызову API. В предоставленных источниках нет подтверждённого универсального кода ответа сервера для неверного ключа, поэтому его нельзя приписывать конкретной ошибке без отдельной документации.

Какой баланс пополняется

Официальный DeepSeek списывает использование с предоставленного или пополненного баланса; при наличии обоих сначала расходуется предоставленный баланс. Zenith ведёт отдельный внутренний баланс: по его условиям он используется для цифрового доступа и фактического API-использования внутри сервиса. Покупка квоты Zenith не пополняет личный аккаунт DeepSeek.

Итоговый выбор определяется не названием в каталоге, а маршрутом: для официального API используйте ключ DeepSeek, https://api.deepseek.com и документированное имя deepseek-flash или deepseek-v4-pro; для Zenith — ZENITH_API_KEY, https://api.zenithmarket.dev/v1 и модель, присутствующую в текущем ответе GET /v1/models. Если требуется именно официальное пополнение DeepSeek, в проверенных материалах нет подтверждённого способа оплаты из России.