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

API-ключ DeepSeek — это секретная строка, по которой API понимает, кто шлёт запрос. Но одного ключа инструменту мало: нужны три значения сразу — ключ, base URL и id модели. Задайте все три, и первый запрос сработает.

Скорее всего, вы искали это потому, что какая-то форма просит «ваш API-ключ DeepSeek»: скрипт, плагин редактора, нода в n8n. Хорошо. Разберём, что просит каждое поле, и отправим один настоящий запрос.

Что такое API-ключ на самом деле#

Представьте карточку от номера в отеле. Она не говорит, кто вы, словами; она просто открывает вашу дверь, а счёт выставляют на ваш номер. API-ключ работает так же: сервер видит его в запросе, понимает, с какого аккаунта списывать, и пропускает вызов. Потеряли карточку — кто угодно зайдёт и запишет расходы на вас, поэтому ключ не держат ни в коде, ни в чатах. (Подробнее — в статье Что такое API-ключ и как хранить его безопасно.)

Документация API DeepSeek (проверено 4 ноября 2026) показывает ту же привычку: ключ кладут в переменную окружения DEEPSEEK_API_KEY до запуска любых примеров, а API работает в формате OpenAI — SDK OpenAI подходит, если поменять api_key и base_url. В этом весь секрет, и поэтому ключ никогда не ходит один.

Есть одна деталь, на которой часто спотыкаются: ключ принадлежит тому сервису, который его выдал. Ключ CheapTokens идёт с адресом CheapTokens и с id модели из списка CheapTokens. Смешайте ключ одного места с адресом другого — получите ошибку авторизации, а не ответ.

Положите ключ в переменную окружения#

Создайте ключ в личном кабинете CheapTokens (шаги — в документации) и пополните баланс, чтобы у запроса было из чего списываться. Затем сохраните ключ в переменную, а не вставляйте его в файл.

macOS или Linux:

export CHEAPTOKENS_API_KEY='paste-your-key-here'

Windows PowerShell (только для текущего окна):

$env:CHEAPTOKENS_API_KEY = 'paste-your-key-here'

paste-your-key-here — заглушка; настоящий ключ подставьте только у себя в терминале и больше нигде. Почему это лучше ключа в коде и что делать, если ключ утёк, — в статье Как хранить API-ключ: переменная окружения, .gitignore, что делать при утечке.

Первый запрос#

Допустим, вы хотите просто убедиться, что всё работает: попросим модель объяснить, что такое API-ключ, одним предложением. Один и тот же запрос двумя способами — берите вкладку, которой пользуетесь.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Explain an API key in one sentence."}],
    "max_tokens": 200
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['CHEAPTOKENS_API_KEY'],
    base_url='https://api.cheaptokens.dev/v1',
)

resp = client.chat.completions.create(
    model='deepseek-ai/DeepSeek-V4-Flash-0731',
    messages=[{'role': 'user', 'content': 'Explain an API key in one sentence.'}],
    max_tokens=200,
)

print(resp.choices[0].message.content)
print(resp.usage)

Для версии на Python один раз нужен pip install openai. Сравните со скриптом, написанным под SDK OpenAI: изменились api_key, base_url и model — те же три значения. Всё остальное осталось как было.

Что вы увидите#

Ответ приходит в JSON. Текст ответа лежит в choices[0].message.content — его скрипт на Python печатает первым. Рядом идёт блок usage с полями prompt_tokens, completion_tokens и total_tokens: сколько токенов ушло на вход, сколько вернулось и сумма. Стоимость считается по этим двум числам, поэтому на них стоит взглянуть даже при первом вызове (Входные и выходные токены объясняют разницу).

Чтобы почувствовать масштаб: такой вызов крошечный. Возьмём 30 токенов на входе и 200 на выходе — потолок max_tokens из примера, то есть самый дорогой вызов, который этот запрос может сделать. Это $0.00002. А вот тысяча таких вызовов, рядом для сравнения OpenRouter:

Модель за этим id — DeepSeek-V4-Flash: контекст 380K токенов и до 32 768 токенов в одном ответе. Цена одинакова в любое время суток, пиковых надбавок нет, а один баланс покрывает все модели. В сумме — вход и выход вместе — выходит дешевле OpenRouter, это и показывает таблица выше. Подробнее о модели: DeepSeek в CheapTokens, актуальные цены — на странице цен.

Если не работает#

Почти любой сбой первого вызова — это одно из трёх значений. Сопоставьте симптом и виновника:

Подробный разбор этих ошибок — в статье Ошибка API 401 или 404: ключ, base URL или id модели. А если не уверены, какой id писать, спросите у самого API: Список моделей через GET /v1/models.

Куда эти три значения пригодятся дальше#

Смысл выучить их один раз — они переносятся. Почти любой инструмент, который работает с OpenAI-совместимым API, просит эти же значения в том или ином виде: ключ, адрес и модель. В скрипте (LangChain, LiteLLM) это аргументы, в приложении или no-code-ноде — поля и настройки. Попробовать можно и без кода — в Postman. Про стриминг и длинные ответы этой модели — быстрый старт с DeepSeek-V4-Flash.