# 错误与重试

> Documentation Index / 文档总索引  
> https://x2v.light-ai.top/llms.txt  
> Source: https://x2v.light-ai.top/api-docs#errors  
> Locale: zh-CN  
> 本页内容已为 Agent/LLM 阅读优化。

先分类错误，再决定重试、修正或停止。

## 稳定响应结构

优先读取 `code`、`message` 或 `error`，以及存在时的机器可读 `details`。每个接口的状态响应以 `/openapi.json` 为准。

## 重试策略

遇到 `429` 必须遵守 `Retry-After`。瞬时 `5xx` 和连接失败可使用有限次数的指数退避并加入抖动。参数校验、余额、权限和内容安全错误不得原样重试；应修正请求、补充权限或余额，或停止。

## 结果未知

提交请求超时且已有 `task_id` 时，先查询原任务。如果未返回 `task_id` 且请求可能已到达服务，不得自动重提；应报告结果未知并要求人工核实。对已知任务使用有限轮询间隔，并在终态停止。

## Related / 相关主题

[quick-start](/api-docs/quick-start.md) · [authentication](/api-docs/authentication.md) · [model-discovery](/api-docs/model-discovery.md) · [task-api](/api-docs/task-api.md) · [workflow-api](/api-docs/workflow-api.md)

OpenAPI: https://x2v.light-ai.top/openapi.json · Live models: https://x2v.light-ai.top/api/v1/model/list · Skill: https://github.com/ModelTC/LightX2V-Skills
