개발자 문서는 영어로 제공됩니다. 사이드바는 선택한 언어를 따릅니다.

지원 및 결제

크레딧, 속도 제한, 오류가 어떻게 동작하는지 — 그리고 업그레이드 방법.

크레딧 및 결제

  • ✅ HTTP 200만 과금: 유료 엔드포인트는 성공 요청당 1 크레딧.
  • ❌ 4xx / 5xx 오류: 과금되지 않음 — 자유롭게 재시도 가능.
  • ❌ 속도 제한(429): 과금되지 않음.
  • ✅ 무료 엔드포인트: /v1/verify, /v1/youtube/channel/resolve, /v1/youtube/channel/latest, GET /v1/youtube/asr/{task_id}(폴링), 모든 /v1/library 읽기.
  • 📦 페이지네이션 엔드포인트: 페이지당 1 크레딧(채널 영상, 플레이리스트).

요금제: 무료 1,000 크레딧 · Pro 월 10,000 크레딧 · 요금제 참고.

속도 제한

각 API 키는 분당 200 요청으로 제한됩니다. 모든 응답에 속도 제한 헤더가 포함됩니다:

헤더설명
X-RateLimit-Limit분당 허용 총 요청 수(200)
X-RateLimit-Remaining현재 윈도우에 남은 요청 수
X-RateLimit-Reset윈도우가 리셋되는 Unix 타임스탬프

초과 시 API는 429와 Retry-After 헤더(초)를 반환합니다.

오류 코드

상태의미과금
200성공예(유료 엔드포인트)
400잘못된 요청 / 누락된 파라미터아니요
401잘못되거나 누락된 API 키아니요
402크레딧 소진아니요
404영상 / 채널 / 자막 없음아니요
429속도 제한 초과아니요
500서버 내부 오류아니요

오류 응답 본문

401 Unauthorized

{ "error": { "code": "UNAUTHORIZED", "message": "Invalid or missing API key" } }

402 크레딧 소진

{ "error": { "code": "CREDITS_EXHAUSTED", "message": "You've run out of credits. Upgrade or top up." } }

404 Not Found(자막 없음)

{ "error": { "code": "NO_CAPTIONS", "message": "No captions available for this video" } }

429 속도 제한

{ "error": { "code": "RATE_LIMITED", "message": "Rate limit exceeded, retry in 12s" } }
// 응답 헤더에도 포함: Retry-After: 12

지원