경계

한도는 계정별로 적용됩니다. 한 계정의 모든 키가 공유합니다.

요금 제한

종착점	분당	시간당	일당
POST /v1/render	3	30	100
POST /api/webhooks/hooks	10	60	200

모든 렌더링은 분 당 5회, 시간당 60회, 하루 300회 등 계정의 전체 렌더링 한도에도 반영됩니다. 이 제한은 앱에서 시작한 렌더링과 공유되기 때문에, 앱 내 팀이 바쁘면 API공간이 줄어듭니다.

요청은 1분, 1시간, 1일의 고정된 시간 창으로 집계됩니다. 초과하면 code: "RATE_LIMITED"와 대기 시간이 retryAfter 또는 details.retryAfter``429 표시됩니다:

{ "error": "Rate limit exceeded", "retryAfter": 37, "code": "RATE_LIMITED" }

GET /v1/me 와 GET /v1/job/{id} 는 현재 속도 제한이 없습니다. 몇 초마다 작업을 폴링하고, 꽉 끼는 루프 안에서 하지 말고, 웹 훅을 사용하세요.

동시 렌더링

계획은 동시에 실행할 수 있는 렌더 수를 정합니다. 앱에서 시작된 렌더링도 포함됩니다. 모든 슬롯이 붐비면 POST /v1/render 429 code: "CONCURRENT_LIMIT" 반환됩니다. 대기열에 있는 것은 없습니다: 실행 작업이 완료될 때까지 기다렸다가 다시 요청을 보내세요.

크레딧 및 사용

• 각 렌더링은 계좌 잔액에서 크레딧을 소모합니다. 크레딧이 부족하면 렌더링 시작 전에 402 (NO_CREDITS 또는 INSUFFICIENT_CREDITS)로 거부됩니다.
• 한 번의 렌더링 비용은 고정된 렌더 한 번의 한도를 초과할 수 없습니다. 그 위에 렌더링하는 것은 413 REQUEST_COST_TOO_HIGH로 거부됩니다. 장면 수를 적게 하거나, 장면을 짧게 하거나, quality을 낮게 사용하세요.
• 각 플랜마다 월 사용 한도가 있습니다. 한도에 도달하면 월이 초기화되거나 플랜이 변경될 때까지 렌더링이 402 ABUSE_CAP_EXCEEDED 거부됩니다.
• 각 도면에는 완성된 비디오를 위한 저장 여유가 있습니다. 라이브러리가 가득 차면 렌더링이 402 STORAGE_FULL로 거부됩니다.

귀하의 플랜 허용액은 계정 및 청구 항목을 참조하세요.

요청 한도

POST /v1/render:

필드	한계
brief	1자에서 4,000자
scene_plan	1장부터 12장까지의 장면
장면 prompt	1자에서 2,000자
장면 script	최대 2,000자
장면 duration	3초에서 10초
duration_sec	5초에서 120초
title	최대 200자
brand_name	최대 80자까지
category	최대 60자
language	2인물에서 10인물
brand_colors	최대 12가지 색상, 각 색상 32자까지
brand_logo_url, product_image_url	최대 5,000,000자 (데이터 URI에 충분함)
Idempotency-Key 헤더	처음 80자 사용됨

웹훅에 대해:

항목	한계
계정별 웹훅	25
webhook_url	최대 2,000자 이하, 공개 http(s) 전용)
description	최대 200자

시간 제한

스텝	한계	무슨 일이 일어나는지
brief 에서 계획하기	약 60초	502 PLAN_FAILED, 계획 크레딧이 환불되었습니다.
렌더링	약 1시간 정도	일자리는 failed 로 표시되며, 크레딧은 환불됩니다.
웹훅 전달	시도당 10초	투구는 최대 3번까지 재시도됩니다.