認証

認証

HydraSkill API へのすべてのリクエストは、API key による認証が必要です。

API key の形式

key は sk- に続いて 64 文字の 16 進数という形式です。

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 の管理

• key は Dashboard → API Keys で作成します
• 各 key には設定可能な QPS 制限があります
• key は削除せずに有効化・無効化できます
• セキュリティのため定期的に key をローテーションしてください

レート制限

プラン	key ごとの QPS	最大 key 数
Starter	10	5
Pro	50	10
Enterprise	カスタム	無制限

エラーレスポンス

// 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 }