调用限制

频率、用量、内容长度等限制和超限时的返回。

各类接口的调用限制如下。超出频率限制时返回 429，按 Retry-After 等待后再试。

模型服务接口

每个密钥有每分钟 token 上限，新建密钥默认每分钟 200 万 token，超出返回 429（RATE_LIMITED）。
余额不足或达到密钥消费上限时返回 402，可在模型服务页充值或调整上限。
一次对话最多 200 条消息、128 个工具；只转发文本，图片和文件不会转给模型。
视频时长 4–15 秒，提交后异步生成；建议带 Idempotency-Key 防止重复提交。

每个字段的长度和取值范围见模型服务接口文档。

AI 助手接入接口

付款、确认高风险事项、验收和联系外部人员由用户本人在网站完成，接口不能代办。
模型写出的材料是待核对的初稿。
也可以用 MCP 接入，见「AI 助手接入（MCP）」指南。

每个字段的长度和取值范围见 AI 助手接入接口文档。

能力网公开接口

只返回公开资料，不含联系方式；下单和付款需要登录后在网站完成。
提交需求前要先征得用户同意留下联系方式；平台联系服务商后回复，不收费，也不会自动下单。
每个来源地址每分钟最多 60 次，所有匿名调用合计每分钟有总上限；超出返回 429 并带 Retry-After: 60。

每个字段的长度和取值范围见能力网公开接口文档。

平台能力共享接口

业务操作保留原账号确认、原功能权限和费用规则；需要确认的操作返回处理中，由账号本人确认后才执行。

每个字段的长度和取值范围见平台能力共享接口文档。

会员接口

密钥放在 X-Zhuge-API-Key 请求头；也可以写成 Authorization: Bearer，两种都带时以 X-Zhuge-API-Key 为准。
每个密钥每分钟最多 120 次请求，超出返回 429。
外包下单、安卓任务草案和商品下单要带幂等键，重复提交不会重复下单；各接口的写法见文档里的请求头参数。
高风险权限（下单、发布、验收等）要人工审核通过后才能使用。
请求一律按密钥绑定的企业和会员处理，客户端传入的租户参数不会被采用。

每个字段的长度和取值范围见会员接口文档。

商家开放接口

只能访问密钥所属店铺的数据。
每个密钥每分钟最多 60 次请求，其中写操作（PUT、POST）最多 20 次，按最近 60 秒计算。
每家店每天最多 10,000 次（所有密钥合计），北京时间 00:00 重新计数。
超限返回 429，并带 Retry-After 响应头，按它给出的秒数等待后再试。

每个字段的长度和取值范围见商家开放接口文档。