인증

인증

모든 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를 주기적으로 교체하세요

Rate Limit

플랜	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" }

// rate limit 초과
{ "error": "rate_limited", "message": "QPS limit exceeded", "retry_after_ms": 1000 }