界限
每个账户都适用限制。一个账户上的所有密钥共享。
| 终点 | 每分钟 | 每小时 | 每天 |
|---|---|---|---|
POST /v1/render |
3 | 30 | 100 |
POST /api/webhooks/hooks |
10 | 60 | 200 |
每次渲染还会计入账户的总渲染限制,每 分钟5次,每小时60次,每天300次。这个限制与应用内开始的渲染共享,因此应用内忙碌的团队会减少 API空间。
请求在固定的时间窗口内计入,时间为一分钟、一小时和一天。超过时,你会 429``code: "RATE_LIMITED" 和等待秒数,具体 retryAfter或 details.retryAfter:
{ "error": "Rate limit exceeded", "retryAfter": 37, "code": "RATE_LIMITED" }GET /v1/me和 GET /v1/job/{id} 现在没有速率限制。每隔几秒轮询一个作业,不要陷入紧密循环,或者改用webhook。
你的套餐会决定同时运行多少渲染。应用内开始的渲染也计入。当每个插槽都忙时,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到4000字符 |
scene_plan |
1至12场景 |
场景 prompt |
1到2000字符 |
场景 script |
最多可达2000字符 |
场景 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个字符被使用 |
关于webhook:
| 项目 | 极限 |
|---|---|
| 每个账户的Webhook | 25 |
webhook_url |
最多2000字符,仅公开HTTP(s) |
description |
最多可达200字符 |
| 步 | 极限 | 会发生什么 |
|---|---|---|
从一个 brief 进行规划 |
大约60秒 | 502 PLAN_FAILED,计划积分退款。 |
| 渲染图 | 大约1小时 | 该职位标记为 failed,积分会被退还。 |
| Webhook 交付 | 每次尝试10秒 | 投球会重试,最多三次尝试。 |