可靠性与重试

超时设置

单次生成可能需要数秒，建议调用方设置 100 秒左右的请求超时。不要因前端页面关闭而立即取消服务端请求。

安全重试

• 相同业务消息重试时复用原 messageId。
• 收到明确的参数、鉴权或余额错误时不要自动重试。
• 仅对 retryable: true、HTTP 429、503 或 504 使用指数退避。
• 建议间隔：1 秒、2 秒、4 秒、8 秒，并加入少量随机抖动。
• 设置总重试次数与告警阈值，避免无限循环。

可观测性

至少记录：调用时间、接口路径、requestId、messageId 或 batchId、HTTP 状态、业务 code、耗时。不得记录 API Key 或未经授权的完整用户隐私数据。

网络结果不确定

如果请求超时但服务端可能已处理，先使用同一 messageId 重试。不要直接生成新 ID，否则可能产生两次回复。