API 参考
API 限流与版本
将 /v1 作为当前路径契约,并依据响应头而非硬编码请求额度处理限制。
查看 Markdown步骤
- 记录状态、错误代码和
x-request-id。 - 遇到
429,按Retry-After或x-ratelimit-reset等待。 - 使用指数退避、随机抖动、最长等待和最多尝试次数。
- 限制并发;没有安全重放说明时,不要重试非幂等操作。
预期结果
客户端可以从临时限制中恢复,避免重复工作,并明确报告不兼容路径。
注意: x-ratelimit-limit、x-ratelimit-remaining 和 x-ratelimit-reset 可能动态变化或显示 unlimited。当前路由不要求另加公共版本请求头。