> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 错误与幂等

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

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

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

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

## 一次操作，一个幂等键

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

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

## 用可追踪 ID 排错

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

[打开日志](https://apistable.com/console/logs)
[查看帮助](https://apistable.com/support)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.