Source: https://01router.com/zh/docs/errors
Base URL: https://01router.com/api/v1

# 错误码

请同时检查 HTTP 状态和 error.message。部分限流响应使用 message 包装并附带 Retry-After。相同 HTTP 状态的错误码可能随接口不同。

## 输出字段

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| 400 · invalid_request | HTTP | — | 请求体或参数取值不合法 |  |
| 401 · unauthorized | HTTP | — | 缺少或无效的 API Key |  |
| 402 · insufficient_credits | HTTP | — | 积分不足 |  |
| 403 · invalid_request | HTTP | — | 密钥或项目不允许调用该模型、供应商或请求来源。 |  |
| 404 · not_found | HTTP | — | 模型或任务不存在 |  |
| 409 · not_cancelable | HTTP | — | 任务无法取消（已结束，或该供应商不支持取消） |  |
| 429 · rate_limited / concurrency_limit | HTTP | — | 请求过于频繁，请稍后重试 · 该 API Key 进行中的任务过多，等部分任务完成后再提交 |  |
| 502 · upstream_error | HTTP | — | 所有供应商都拒绝了任务（积分已退回） |  |
| 503 · no_provider / upstream_error | HTTP | — | 没有供应商支持这些参数 |  |
| 504 · timeout | HTTP | — | 等待超时但图片仍在生成，请轮询 GET /generations/:id |  |

## 401 · application/json

```json
{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}
```

## 使用说明

- 轮询间隔至少 3 秒。同步生图接口返回 504 时，任务可能仍在进行，应使用 error.id 查询，避免重复创建。