---
document_id: agent.paths.api.errors
schema_version: 2
parent_document_id: agent.paths.api
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# API error handling / API 错误处理

## Act on the error / 根据错误采取动作

保留服务端错误 code、请求或任务 ID，以及 documentation 链接。先处理明确的输入、权限、余额或限流问题；只按实际 retryable、等待提示和幂等合同决定是否重试。

Preserve the error code, request or task ID and documentation link. Resolve explicit input, access, balance or rate-limit errors first; retry only according to retryable, waiting hints and the idempotency contract.

结果未知时先查原任务或结果，已有成功结果不重新执行。具体错误码和恢复动作见[错误参考](https://docs.asklear.cn/errors)；收费与结算以对应接口和返回元数据为准。

For unknown outcomes, inspect the original task or result; do not execute successful work again. See the [error reference](https://docs.asklear.cn/en/errors) for codes and recovery actions. Charges and settlement follow the endpoint and returned metadata.
