行为、错误与重试规则
- 只上传完成请求所需的内容;文件或敏感长文本上传前取得同意。
- 同一逻辑请求复用
Idempotency-Key,内容改变时使用新值。 - 不回显密钥、完整原始响应或无关内部诊断。
- 翻译读取
data.tgtText,对话读取choices[0].message.content;缺失则失败关闭。 validation_failed(验证失败):修正字段、语言代码或长度。insufficient_balance(余额不足):提示充值,不自动重发。rate_limited(受到速率限制):遵循Retry-After或有限指数退避。upstream_unavailable(上游服务不可用):短暂退避并复用原幂等键,限制重试次数。idempotency_in_progress(幂等请求处理中):等待原请求,不换密钥并发提交。idempotency_key_reused(幂等键已被重复使用):仅请求内容确实不同才换新密钥。idempotency_indeterminate(幂等结果不确定):停止自动重试,先核对原请求和账单。document_extraction_failed(文档提取失败):更换可解析文件或改用纯文本。
普通文本翻译、对话和 Word 请求的幂等重放返回首次响应与首次计费头。统一计费头为
X-AI-Skills-Billing-Currency、X-AI-Skills-Billing-Charged、
X-AI-Skills-Billing-Balance。
图片和 PDF 翻译是隐私例外:客户端必须在收到时保留首次完整响应。成功重放只返回带
replayed=true、content_retained=false 的无内容摘要,不包含 srcText、tgtText 或 pages,
且不会再次调用上游或扣费。