身份认证

身份认证

所有 HydraSkill API 请求都需要通过 API key 进行认证。

API Key 格式

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()

Key 管理

• 在 Dashboard → API Keys 中创建 key
• 每个 key 都有可配置的 QPS 限制
• key 可以启用/禁用，无需删除
• 定期轮换 key 以保障安全

速率限制

套餐	每个 Key 的 QPS	最大 Key 数量
Starter	10	5
Pro	50	10
Enterprise	自定义	无限制

错误响应

// API key 无效或缺失
{ "error": "unauthorized", "message": "Invalid API key" }

// key 已禁用
{ "error": "forbidden", "message": "API key is disabled" }

// 触发速率限制
{ "error": "rate_limited", "message": "QPS limit exceeded", "retry_after_ms": 1000 }