错误与幂等

安全恢复，避免重复生成和收费。

当前为 API 预览。生成接口尚未接入供应商，成功认证后仍可能返回 503；不会创建任务或扣积分。

​

按原因处理，不只看 HTTP 状态

类别	处理方式
认证 / 权限	检查密钥与模型权限，不自动重试。
参数错误 / 能力不支持	修正输入，不静默删除字段。
积分不足 / 上限过低	重新提交前检查数量、fallback 与报价。
供应商尚未配置	预览模型可能返回此错误，暂无真实成功输出。
上游结果未知	保留任务 ID 并查询，不重复创建。
限流	遵守 Retry-After 并有限退避。

​

一次操作，一个幂等键

恢复同一请求时使用稳定 Idempotency-Key。指纹包含模型、规范化输入、output_count、fallback 和 max_credits；同键不同业务输入属于冲突。

幂等键不是认证凭据；它防止重复受理，不提供访问权限。用户主动重新生成是新操作，应使用新键。

​

用可追踪 ID 排错

保留 request_id、task_id、item_id、时间与脱敏错误。不要发送完整密钥或供应商凭据。日志展示父操作、各结果项、尝试与积分结果。

打开日志 查看帮助