限制与超时

合理设置输入规模、并发与等待时间。

能力边界

请求受 API Key 权限、账户余额和服务限流约束。参数类型、必填项及取值说明见各接口文档。

文件和文本应按业务需要控制大小;收到 HTTP 413 时减小输入,收到 HTTP 429 时降低并发。批量处理建议分批提交,并保留每个请求的编号。

超时处理

客户端应分别设置连接超时和请求超时。

遇到请求超时,保留请求编号和时间,核查调用记录后再决定是否重试。

限流响应

收到 HTTP 429 时减少并发,遵循响应中的 Retry-After(如有)。不要通过立即重复请求绕过限流。

持续超限时,检查多个应用是否共用同一 API Key,并调整各应用的请求频率。

文件与格式

文件处理使用 multipart 上传,具体字段和可用目标格式见对应接口文档。文件后缀需要与实际内容相符。

损坏文件、受密码保护的文档以及不支持的格式组合可能处理失败。请根据错误响应检查文件,必要时解密或转换为支持的格式后重试。