Ключ API DeepSeek: що куди вставляти та перший виклик

Ключ API DeepSeek — це секретний рядок, який повідомляє API, хто надсилає запит. Однак інструменту ніколи не потрібен лише ключ: йому потрібні три значення разом — ключ, базова URL-адреса та ідентифікатор моделі. Встановіть ці три, і перший виклик спрацює.

Ви, ймовірно, шукали це, бо якась форма запитує у вас "ваш ключ API DeepSeek": скрипт, плагін редактора, вузол n8n. Гаразд. Давайте подивимося, що хоче кожне поле, а потім надішлемо один реальний запит.

Що таке API-ключ насправді?#

Уявіть картку-ключ від готельного номера. Вона не каже словами, хто ви; вона просто відчиняє ваші двері, а стійка реєстрації виставляє рахунок на ваш номер. API-ключ робить те саме: сервер бачить його в запиті, знає, з якого рахунку списати кошти, і пропускає виклик. Загубіть картку — і будь-хто зможе увійти й виставити рахунок на ваш номер, тому ключ тримають поза кодом і поза чатами. (Довша історія — у Що таке API-ключ і як зберігати його безпечно.)

Власна документація API DeepSeek (перевірено 4 листопада 2026 року) демонструє ту саму звичку: ключ поміщають у змінну середовища, DEEPSEEK_API_KEY, перш ніж запускати будь-який приклад, а API дотримується формату OpenAI — SDK OpenAI працює, щойно ви зміните api_key та base_url. Ось і весь трюк, і саме тому ключ ніколи не подорожує сам.

Одна деталь, яка збиває людей з пантелику: ключ належить сервісу, який його видав. Ключ CheapTokens поєднується з адресою CheapTokens, а ідентифікатор моделі — той, що вказаний у 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 для порівняння:

Модель за цим ідентифікатором — DeepSeek-V4-Flash: контекстне вікно 380K токенів і до 32 768 токенів в одній відповіді. Ціна однакова в будь-яку годину, без націнки за піковий час, і один баланс покриває всі моделі. Загалом — вхід і вихід разом — виходить дешевше, ніж OpenRouter, що саме й показує таблиця вище. Докладніше про модель: DeepSeek на CheapTokens, актуальні ціни на сторінці цін.

Коли не працює#

Майже кожна невдача першого виклику — це одне з трьох значень, вказане неправильно. Зіставте симптом із причиною:

Повний розбір цих помилок — у Помилка API 401 або 404: неправильний ключ, базова URL-адреса або ідентифікатор моделі. А якщо ви не впевнені, який ідентифікатор використовувати, запитайте сам API: Список моделей за допомогою GET /v1/models.

Куди ті самі три значення йдуть далі#

Сенс вивчити їх один раз — у тому, що вони переносні. Майже будь-який інструмент, що спілкується з API, сумісним з OpenAI, запитує ці самі значення в тій чи іншій формі: ключ, адресу та модель. У скрипті (LangChain, LiteLLM) це аргументи; у застосунку або вузлі no-code це поля або налаштування. Ви також можете спробувати їх без написання коду в Postman. Для потокової передачі та довгих відповідей із цією моделлю продовжте з швидкого старту DeepSeek-V4-Flash.