Authentication

Authentication

All HydraSkill API requests require authentication via API key.

API Key Format

Keys follow the format: sk- followed by 64 hex characters.

sk-a1b2c3d4e5f6...

Authentication Methods

Header (Recommended)

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

SDK (Auto-configured)

from hydraskill import ProxyClient

# Option 1: Pass directly
client = ProxyClient(api_key="sk-your-key-here")

# Option 2: Environment variable (recommended)
# export HYDRASKILL_API_KEY="sk-your-key-here"
client = ProxyClient()

Key Management

• Create keys in Dashboard → API Keys
• Each key has configurable QPS limits
• Keys can be enabled/disabled without deletion
• Rotate keys regularly for security

Rate Limits

Plan	QPS per Key	Max Keys
Starter	10	5
Pro	50	10
Enterprise	Custom	Unlimited

Error Responses

// Invalid or missing key
{ "error": "unauthorized", "message": "Invalid API key" }

// Key disabled
{ "error": "forbidden", "message": "API key is disabled" }

// Rate limited
{ "error": "rate_limited", "message": "QPS limit exceeded", "retry_after_ms": 1000 }