限制
Direct API 的请求速率限制、报告这些限制的响应头，以及大小和数量限制。
请求速率
| 额度类别 | 限制 | 计算单位 |
|---|---|---|
| 生成任务读取 | 每个生成任务每分钟 30 次，总计每分钟 1,200 次 | API 密钥 |
免费工具调用（列表、目录、plan_media，以及调用导入的每个媒体 URL） | 每小时 1,000 次 | API 密钥 |
webhook 管理（/webhooks 及其子路径） | 每分钟 60 次 | API 密钥 |
/usage、/me | 每分钟 60 次 | API 密钥 |
API 密钥无效的请求（401） | 每 10 分钟 60 次；超出后，来自该地址的请求会返回 429（附带 Retry-After），直到时间窗口结束，但最近 10 分钟内通过认证的密钥除外 | 客户端 IP 地址（IPv6 地址按其 /64 计） |
| 付费工具调用 | 无请求速率限制 |
- 付费调用受金额约束，而不是受速率约束：即你的密钥的 积分上限 和组织的余额。
- 在高负载下，生成任务会在
queued状态等待模型容量，而不会被拒绝。启动超出模型同时处理能力的工作，会让后续的生成任务耗时更长，但绝不会导致失败。 - 结果最终免费的付费调用（例如对无声视频调用
video_remove_audio），计入免费调用额度。
速率限制响应
每个受速率限制的端点都会返回以下响应头：
X-RateLimit-Limit: 1200
X-RateLimit-Remaining: 1187
X-RateLimit-Reset: 1792919760被拒绝的请求会返回 429，带有 Retry-After: <seconds> 和以下响应体：
{
"description": "This API key read generations more than 1200 times a minute. Poll less often, or pass ?wait= to be answered when a status changes.",
"code": "rate_limited",
"data": { "retry_after_seconds": 14 }
}等待 Retry-After 秒后再重试。429 从不扣费。
大小和数量限制
| 限制 | 值 |
|---|---|
| 请求体 | 1 MB |
每次图片启动的 variations | 1 到 4 |
| 每次批量读取的 ID 数 | 10 |
wait | 45 秒 |
metadata | 20 个键；键最长 40 个字符，值最长 500 个字符 |
Idempotency-Key | 最长 200 个字符，保留 24 小时 |
| 每个组织的有效 API 密钥数 | 10 |
| 每个组织的 webhook 端点数 | 10 |
| 素材链接有效期 | 永不过期 |
| 各模型的输入（提示词长度、参考图片、时长、文件大小） | 见 模型 及每个工具的 input_schema |
如果您遇到任何问题或有任何疑问，欢迎随时联系我们。我们很乐意提供帮助。请发送邮件至 support@morphic.com.