Xác Thực & Mã Lỗi

Xác Thực

Tất cả các yêu cầu API đều yêu cầu xác thực qua một trong hai phương thức:

curl -H "X-API-Key: ck_live_your_key" \
  "https://claudekit.cc/api/proxy/vidcap/v1/youtube/info?url=..."

curl -H "Authorization: Bearer ck_live_your_key" \
  "https://claudekit.cc/api/proxy/vidcap/v1/youtube/info?url=..."

API keys có định dạng ck_live_ theo sau là 32 ký tự ngẫu nhiên.

Mã	HTTP Status	Mô tả
`MISSING_API_KEY`	401	Không có API key trong request headers
`INVALID_API_KEY`	401	API key không hợp lệ hoặc đã hết hạn
`KEY_EXPIRED`	401	API key đã hết hạn
`KEY_REVOKED`	401	API key đã bị thu hồi
`LICENSE_REQUIRED`	403	Yêu cầu giấy phép ClaudeKit đang hoạt động
`RATE_LIMIT_EXCEEDED`	429	Quá nhiều yêu cầu, thử lại sau thời gian chờ
`INVALID_PATH`	400	Định dạng proxy path không hợp lệ
`UNKNOWN_SERVICE`	404	Dịch vụ yêu cầu không tìm thấy

{
  "error": "INVALID_API_KEY",
  "message": "The provided API key is invalid or has expired"
}

Các yêu cầu API bị giới hạn tốc độ theo từng API key. Giới hạn được thông báo qua response headers.

Header	Mô tả
`X-RateLimit-Limit`	Số yêu cầu tối đa mỗi giờ
`X-RateLimit-Remaining`	Số yêu cầu còn lại trong cửa sổ hiện tại
`X-RateLimit-Reset`	Unix timestamp khi cửa sổ được đặt lại

Khi bị giới hạn tốc độ, bạn nhận được phản hồi 429:

{
  "error": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 120
}

Trường retryAfter cho biết số giây cần chờ trước khi thử lại.

Gói	Yêu Cầu/Giờ
Standard	1,000
Premium	10,000