К содержимому
Блог

DeepSeek API Key: ключ Relay и первый запрос к модели

DeepSeek API Key: ключ Relay и первый запрос к модели

DeepSeek API Key получают у того сервиса, куда приложение отправляет запросы. Для прямого API DeepSeek нужен его ключ, для Relay нужен ключ из кабинета Relay. Чтобы вызвать модель через Relay, задайте https://relay-llm.ru/v1, передайте ключ и точный идентификатор модели. Ниже показаны проверка через curl и такой же вызов из Python. Ключ Relay не подходит для входа в чат или кабинет DeepSeek.

Коротко

  • Не смешивайте адрес одного сервиса с ключом другого.

  • Используйте deepseek-v4-flash из каталога Relay, а не имя из примера другой платформы.

  • Храните секрет на сервере и ограничьте расход отдельным ключом приложения.

Где получить DeepSeek API Key для работы через Relay

Если вы ищете, как получить API-ключ DeepSeek для готового приложения, сначала откройте его настройки. Для Relay клиент должен поддерживать OpenAI Chat Completions и собственный базовый адрес. Клиент с жёстко заданным адресом DeepSeek не переключится на Relay после замены одного секрета.

В Relay создайте доступ по шагам:

  1. Зарегистрируйтесь, подтвердите почту и откройте «API-ключи».

  2. Создайте ключ с именем приложения, например support-dev.

  3. Скопируйте секрет при создании. После закрытия окна он больше не показывается.

  4. Выберите разрешённые модели и задайте лимит, если нужно ограничить тест.

  5. Проверьте доступный баланс перед первым платным вызовом.

Все ключи аккаунта используют общий баланс. Отдельный ключ позволяет отозвать доступ конкретного приложения и посмотреть его запросы; сам по себе он не создаёт отдельный счёт. Способы и условия пополнения смотрите на странице цен и в кабинете.

Как проверить ключ запросом curl

Откройте каталог DeepSeek и скопируйте идентификатор. В примере используется существующий deepseek-v4-flash. Идентификатор другого сервиса может не совпадать с ним: не заменяйте его названием семейства или подписью на кнопке.

bash
curl -i "https://relay-llm.ru/v1/chat/completions" \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Объясни HTTP одним предложением."}]
  }'

Ключ в примере вымышленный. Для реальной проверки передайте свой секрет через окружение и замените заголовок на Authorization: Bearer $RELAY_API_KEY, оставив двойные кавычки. Не вставляйте рабочий ключ в сохранённую команду или снимок терминала.

Флаг -i показывает заголовки ответа. Сохраните x-request-id, если потребуется найти запрос в кабинете или обратиться в поддержку. Сам ключ туда не прикладывайте. Поля запроса описаны в документации Chat Completions.

DeepSeek V4 Flash0,08 $ за 1 млн входных токенов

Как перенести проверенный вызов в Python

Пример рассчитан на установленный пакет openai. В SDK передают базовый адрес, без /chat/completions: библиотека допишет маршрут сама. Сначала используйте то же сообщение, что в curl, чтобы сравнивать подключение без влияния нового промпта.

python
from openai import OpenAI

client = OpenAI(
    api_key="sk-demo-not-a-real-key",
    base_url="https://relay-llm.ru/v1",
    max_retries=0,
)
result = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "Объясни HTTP одним предложением."}],
)
print(result.choices[0].message.content)
print(result.usage)

В серверном коде импортируйте os и берите ключ через os.environ["RELAY_API_KEY"]. Запускайте файл в том окружении, где переменная установлена. Если curl работает, а Python получает 401, проверьте именно окружение процесса Python, прежде чем менять модель или перевыпускать секрет.

Не добавляйте поток и инструменты одновременно. Сначала проверьте обычный текстовый ответ, затем каждый нужный параметр. Это позволяет связать новый отказ с конкретным изменением запроса.

Почему API возвращает ошибку

401 указывает на авторизацию. Проверьте секрет и состояние ключа: отключение, отзыв и истёкший срок тоже делают его непригодным для запроса. При 403 проверьте, разрешена ли модель этому ключу.

404 требует чтения тела ошибки. model_not_found означает неизвестную модель; not_found может указывать на неверный маршрут. Для 503 model_unavailable проверьте доступность модели и протокол. Не лечите все эти случаи заменой ключа.

402 key_limit_exceeded не исправляется пополнением баланса: нужно изменить лимит ключа или дождаться нового периода. При insufficient_balance проверьте доступную сумму с учётом резервов текущих запросов. Для 429 следуйте x-should-retry и Retry-After, не запускайте бесконечные повторы. Подробности есть в справочнике ошибок.

После успешного ответа сверьте ключ, модель и стоимость в истории запросов. usage показывает токены, а фактическое списание проверяют по записи в кабинете. Если секрет раскрыт, отзовите ключ, обновите конфигурацию приложения и повторите короткую проверку.

Можно ли получить DeepSeek API Key в Relay?

В Relay создаётся собственный ключ для API Relay. Ключ прямой платформы DeepSeek получают отдельно у DeepSeek.

Нужен ли ключ от чата DeepSeek?

Для показанного API-вызова нужен ключ Relay. Учётные данные чата в запрос не передаются.

Почему модель из чужого примера не найдена?

У сервисов могут различаться идентификаторы. Скопируйте значение из каталога Relay и проверьте путь запроса.

Можно ли дать один ключ нескольким приложениям?

Можно, но отзыв затронет их все, а лимит будет общим. Разделите ключи, если нужно отдельно ограничивать расход и отключать приложения.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.