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 создайте доступ по шагам:
Зарегистрируйтесь, подтвердите почту и откройте «API-ключи».
Создайте ключ с именем приложения, например
support-dev.Скопируйте секрет при создании. После закрытия окна он больше не показывается.
Выберите разрешённые модели и задайте лимит, если нужно ограничить тест.
Проверьте доступный баланс перед первым платным вызовом.
Все ключи аккаунта используют общий баланс. Отдельный ключ позволяет отозвать доступ конкретного приложения и посмотреть его запросы; сам по себе он не создаёт отдельный счёт. Способы и условия пополнения смотрите на странице цен и в кабинете.
Как проверить ключ запросом curl
Откройте каталог DeepSeek и скопируйте идентификатор. В примере используется существующий deepseek-v4-flash. Идентификатор другого сервиса может не совпадать с ним: не заменяйте его названием семейства или подписью на кнопке.
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.
Как перенести проверенный вызов в Python
Пример рассчитан на установленный пакет openai. В SDK передают базовый адрес, без /chat/completions: библиотека допишет маршрут сама. Сначала используйте то же сообщение, что в curl, чтобы сравнивать подключение без влияния нового промпта.
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 и проверьте путь запроса.
Можно ли дать один ключ нескольким приложениям?
Можно, но отзыв затронет их все, а лимит будет общим. Разделите ключи, если нужно отдельно ограничивать расход и отключать приложения.