Начало работы

Аутентификация

Canonical inference routes принимают API key. Dashboard/account endpoints используют отдельный JWT-сеанс.

Получение ключа

1.Зарегистрируйтесь. При password registration backend выдаёт Welcome Key один раз.
2.Если полный секрет недоступен, откройте Dashboard → API-ключи, создайте новый и сразу скопируйте его.
3.Новые публичные ключи получают scope inference:canonical_vllm, нужный для /vllm/v1/models и /vllm/v1/chat/completions.

Формат

sk-0123456789abcdef0123456789abcdef

Префикс sk- и 32 случайных шестнадцатеричных символа. Значение выше — только пример формата.

Заголовок запроса

Authorization: Bearer

Рекомендуемый вариант и формат, который использует OpenAI client.

Terminal

curl -sS https://api.42gpu.ru/vllm/v1/chat/completions \
  -H "Authorization: Bearer $GPU42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Qwen/Qwen3.5-397B-A17B-FP8","messages":[{"role":"user","content":"Привет"}]}'

X-API-Key

Поддерживаемая альтернатива для собственного HTTP-клиента.

Terminal

curl -sS https://api.42gpu.ru/vllm/v1/chat/completions \
  -H "X-API-Key: $GPU42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"Qwen/Qwen3.5-397B-A17B-FP8","messages":[{"role":"user","content":"Привет"}]}'

Без shell history

Terminal

read -rsp "42gpu API key: " GPU42_API_KEY && echo
export GPU42_API_KEY

# После работы с текущей shell-сессией:
unset GPU42_API_KEY

Для CI и production используйте secret manager. Файл .env должен быть исключён из Git.

Полный ключ показывается только при выдаче.

Не отправляйте его в поддержку, логи, screenshots или bug reports. При возможной утечке отзовите ключ и создайте новый.

Типовые ответы

HTTP	code	Что проверить
401	`missing_api_key / invalid_api_key`	Заголовок, полный секрет и активность ключа.
403	`missing_canonical_vllm_scope`	Создайте актуальный inference key в Dashboard.
403	`account_disabled`	Статус аккаунта.
402	`insufficient_balance`	Баланс в Dashboard.