境界

制限はアカウントごとに適用されます。1つのアカウントのすべてのキーは共有します。

料金制限

終着点	分単位	時間あたり	1日あたり
`POST /v1/render`	3	30	100
`POST /api/webhooks/hooks`	10	60	200

また、1回のレンダリングはアカウント全体のレンダリング制限( 1分あたり5回、1時間あたり60回、1日300回)にもカウントされます。この制限はアプリ内で開始されたレンダリングと共有されるため、アプリ内の忙しいチームが APIのスペースを残しません。

リクエストは1分、1時間、1日の固定されたウィンドウでカウントされます。オーバーすると、code: "RATE_LIMITED"と待機時間が入力されて429``retryAfterまたはdetails.retryAfterで表示されます:

{ "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)で拒否されます。
1つのレンダリングは固定された1回のレンダリング上限を超えてはなりません。その上でのレンダリングは 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のみ
`description`	最大200文字まで

時間制限

ステップ	制限	何が起こるか
`brief`からの計画	約60秒	`502 PLAN_FAILED`、計画クレジットは返金されました。
レンダリング	約1時間	その仕事は `failed` とマークされ、そのクレジットは返金されます。
ウェブフックの配信	1回の試みにつき10秒	投球は最大3回まで再挑戦されます。