本规则同时适用于 API 请求和 MCP 工具调用。
开放平台采用统一的调用频率与访问限制规则,API 与 MCP 均受影响。切换协议、接口或客户端不代表已解除访问限制。
开放平台的调用频率上限为 10 QPS(每秒最多 10 次请求)。请均匀发起请求,避免短时间集中调用或连续重试。
QPS 表示每秒请求数量,不等于同时执行的连接数。查询调用额度与请求频率是两项不同规则:额度充足时仍需遵守频率限制。
| 业务码 | 含义 | API | MCP |
|---|---|---|---|
| 50202 | 调用频率超限 | 按 HTTP 状态及业务响应判断,暂停请求后降低频率 | 查看工具错误结果,停止连续调用,等待后再尝试 |
| 50201 | 访问受到限制 | 按提示前往爱给网站处理,完成后再继续调用 | |
API 的此类业务错误使用 HTTP 429。MCP 工具执行错误应检查 isError 及结果中的 code,不要只根据 HTTP 连接是否成功判断业务结果。
如果响应提示预计等待时间,请按提示等待;没有等待时间时逐步延长重试间隔,并限制重试次数。
aigei_work 申请额度后继续。网络超时不一定表示服务端未处理请求。涉及下载费用且无法确认处理结果时,请通过爱给网站的“联系客服”入口反馈,并提供请求时间、错误信息与 requestId,避免盲目重试。
按错误提示处理后仍无法恢复,请前往爱给网站,通过“联系客服”入口反馈,便于客服定位并协助解决问题。