Оглавление

API-ключ DeepSeek — это секретный ключ, который подтверждает ваши запросы к https://api.deepseek.com. Его создают в кабинете разработчика и передают в заголовке Authorization: Bearer.

Быстрый старт: 5 шагов

Откройте платформу. Перейдите на https://platform.deepseek.com/ и нажмите Sign in / Sign up.

Платформа дипсик→ вход или регистрация.

Регистрируемся на платформе Deepseek

  1. Откройте раздел ключей. В кабинете перейдите в API Keys (обычно в навигации «Developer» → «API Keys»).

    Старница АПИ на дипсик

    Кликаем на страницу с ключаем и создаем здесь ключ

  2. Создайте ключ. Нажмите Create new API key, задайте понятное имя (например, prod-backend), подтвердите создание.

    Создаем Апи ключ на дипсик

    Жмем на Create API key кнопку и даем название нашему ключу

  3. Скопируйте и сохраните. Сразу скопируйте ключ — позже он не будет показан. Сохраните в менеджере секретов или переменной окружения сервера (DEEPSEEK_API_KEY).

    Сохранение АПИ ключа дипсик

    Сохраните ваш ключ сразу — как только вы закроете окно у вас больше не будет такой возможности

    Важно: ключ приватный. Не вставляйте его в публичные репозитории и клиентский фронтенд. И просто не пересылайте никому без необходимости.

  4. Далее идем в раздел пополнения баланса. Сам по себе ключ у дипсик бесплатный, но, чтобы им пользоваться увы нужно пополнить баланс. В отличие от чата, которым можно пользоваться бесплатно. В разделе Top Up убедитесь, что пополнение выполнено/настроено. Цены считаются по токенам; с 5 сентября 2025, 16:00 UTC действует обновлённый прайс.

    Пополнение АПИ дипсик

    Пополняем баланс удобным для вас способом

  5. Сделайте тестовый запрос. Выполните запрос к https://api.deepseek.com/chat/completions с заголовком Authorization: Bearer <ваш_ключ> (см. пример ниже).

Коротко: как сделать тестовый запрос к DeepSeek

  • Экспортируйте ключ в переменную окружения (терминал)
export DEEPSEEK_API_KEY="ВАШ_КЛЮЧ"
  • Выполните запрос (curl):
curl -sS https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
--data-raw '{"model":"deepseek-chat","messages":[{"role":"user","content":"Привет!"}],"stream":false}'
  1. Ожидайте JSON с полем choices[0].message.content — там будет ответ модели.
  • Если получили 401 — неверный/пустой ключ или заголовок.
  • Если «зависает» или идут пустые строки — дождитесь завершения (keep-alive при нагрузке) или повторите позже.
  • Не публикуйте ключ и не используйте его в клиентском фронтенде.
Проверка API Deepseek

Проверяем, что ключ работает

Ключевые понятия

Термин Простое объяснение
API-ключ Секрет для авторизации запросов к DeepSeek; хранится на сервере.
Bearer Формат заголовка авторизации: Authorization: Bearer <KEY>.
base_url Адрес API: https://api.deepseek.com (допустимо /v1 для совместимости с OpenAI SDK).
Модели deepseek-chat (non-thinking) и deepseek-reasoner (thinking), обе — V3.1.

Как это работает

  • Аккаунт → ключ. В кабинете создаётся секрет, видимый один раз.
  • Хранение. Ключ кладётся в переменные окружения/secret-manager; доступ ограничен.
  • Запрос. Клиент (ваш сервер) шлёт HTTPS на api.deepseek.com с заголовком Bearer.
  • Ответ. Возвращается JSON; биллинг считает входные/выходные токены.
  • Нагрузка. При перегрузке возможны keep-alive строки/комментарии; соединение может висеть до ~30 минут.

Мини-схема: Клиент → Authorization: Bearer → DeepSeek API → Модель → JSON-ответ → списание токенов.

Сильные и слабые стороны

Аспект Что хорошо Что ограничивает
Получение ключа Пара кликов; можно сразу вызывать API. Ключ показывается один раз — нужна дисциплина хранения.
Совместимость Совместимо с OpenAI-форматом и SDK при установке base_url. Важно не забыть указать https://api.deepseek.com.
Производительность V3.1; длинный контекст; разумные цены. При пиках возможны задержки и keep-alive; до 30 минут.
Биллинг Прозрачные тарифы «за 1M токенов». Цены меняются — перед релизом сверяйтесь со страницей Pricing.

Типичные ошибки и как избежать

  • Секрет в репозитории или фронтенде. Храните в переменных окружения/secret-manager; доступ по принципу минимально необходимого.
  • Неверный base_url. Используйте https://api.deepseek.com (или /v1 для совместимости SDK).
  • Потеря ключа. Создайте новый и удалите старый; заведите отдельные ключи для dev/stage/prod.
  • Паника из-за пустых строк. Это keep-alive; корректно обрабатывайте нестриминговые пустые строки и SSE-комментарии.
  • Неактуальные цены. Проверяйте раздел Pricing; с 5 сентября 2025 16:00 UTC нет ночных скидок.

Дальше по теме

  • Your First API Call — параметры базового вызова, примеры для curl/Python/Node.
  • Authentication — схема Bearer и создание ключа.
  • Models & Pricing — действующие тарифы и уведомление о смене цен.
  • Rate Limit — поведение при высокой нагрузке и тайм-аут.
  • Service Status — инциденты и плановые работы.

Источники

  1. DeepSeek API Docs — Your First API Call — совместимость с OpenAI-форматом, base_url, примеры вызовов.
  2. DeepSeek API — Authentication — требование создать API-ключ; Bearer-аутентификация.
  3. Models & Pricing — переход на новый прайс с 5 сентября 2025, 16:00 UTC; актуальные ставки.
  4. Rate Limit — отсутствие фиксированных rate-limits, keep-alive и закрытие соединения через ~30 минут.
  5. DeepSeek-V3.1 Release (2025-08-21) — анонс модели и изменения цен.
  6. DeepSeek Platform — кабинет разработчика для создания ключа и управления биллингом.