能力边界
请求受 API Key 权限、账户余额和服务限流约束。参数类型、必填项及取值说明见各接口文档。
文件和文本应按业务需要控制大小;收到 HTTP 413 时减小输入,收到 HTTP 429 时降低并发。批量处理建议分批提交,并保留每个请求的编号。
超时处理
客户端应分别设置连接超时和请求超时。
遇到请求超时,保留请求编号和时间,核查调用记录后再决定是否重试。
限流响应
收到 HTTP 429 时减少并发,遵循响应中的 Retry-After(如有)。不要通过立即重复请求绕过限流。
持续超限时,检查多个应用是否共用同一 API Key,并调整各应用的请求频率。
文件与格式
文件处理使用 multipart 上传,具体字段和可用目标格式见对应接口文档。文件后缀需要与实际内容相符。
损坏文件、受密码保护的文档以及不支持的格式组合可能处理失败。请根据错误响应检查文件,必要时解密或转换为支持的格式后重试。