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

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

Все запросы к API HydraSkill требуют аутентификации с помощью API key.

Формат API key

Ключи имеют формат: sk-, за которым следуют 64 шестнадцатеричных символа.

sk-a1b2c3d4e5f6...

Методы аутентификации

Заголовок (рекомендуется)

curl https://api.hydraskill.ai/v1/proxy \
  -H "Authorization: Bearer sk-your-key-here"

SDK (настраивается автоматически)

from hydraskill import ProxyClient

# Вариант 1: передать напрямую
client = ProxyClient(api_key="sk-your-key-here")

# Вариант 2: переменная окружения (рекомендуется)
# export HYDRASKILL_API_KEY="sk-your-key-here"
client = ProxyClient()

Управление ключами

• Создавайте ключи в Dashboard → API Keys
• У каждого ключа настраиваемые лимиты QPS
• Ключи можно включать/отключать без удаления
• Регулярно меняйте ключи в целях безопасности

Лимиты запросов

Тариф	QPS на ключ	Макс. ключей
Starter	10	5
Pro	50	10
Enterprise	Индивидуально	Без ограничений

Ответы с ошибками

// Неверный или отсутствующий ключ
{ "error": "unauthorized", "message": "Invalid API key" }

// Ключ отключён
{ "error": "forbidden", "message": "API key is disabled" }

// Превышен лимит запросов
{ "error": "rate_limited", "message": "QPS limit exceeded", "retry_after_ms": 1000 }