状态码

所有 API 类型的状态码参考

更新日期：2026-06-06

HTTP 状态码

状态码	说明	处理建议
200	请求成功	-
400	请求参数错误	检查请求体格式和参数
401	认证失败	检查 API Key 是否正确
403	权限不足	检查令牌是否有权限访问该模型
404	资源不存在	检查 URL 路径
429	请求频率超限	降低请求频率或联系管理员
500	服务端 5xx 错误	可重试；可能是本站内部错误，也可能是上游 5xx 通过本站返回
502	网关或上游结果获取失败	通常表示已进入上游调用阶段，但未能拿到有效上游响应或结果，可重试
503	服务不可用	系统维护中

500 是更宽泛的服务端错误。在 Crazyrouter 中，它既可能表示本站内部错误，也可能表示上游直接返回了 5xx，再由本站中继给客户端。

502 更具体，通常表示请求已经到达 Crazyrouter 的网关或上游调用阶段，但 Crazyrouter 无法拿到有效的上游响应或结果，例如上游不可达、返回无效网关级响应，或任务结果地址取回失败。

如果同类问题持续出现：

大量 502 通常优先检查上游渠道可用性、网络连通性和结果 URL 是否可访问。

大量 500 需要结合错误类型和日志进一步区分；只有明确标记为站内 site_internal 或 panic 一类时，才应直接视为 Crazyrouter 自身问题。

{
  "error": {
    "message": "错误描述",
    "type": "error_type",
    "code": "error_code"
  }
}

任务不存在时返回 HTTP 400 {"code":"task_not_exist"}；GET /v1/tasks/{task_id} 则返回 404。

Warning: 遇到 429 错误时，请勿立即重试。建议使用指数退避策略（Exponential Backoff），初始等待 1 秒，每次翻倍。

最后校验/修改：2026-09-28（删除 Midjourney / Luma / Runway 状态码段（未上架）；视频任务状态改为实测值（不存在返回 400 task_not_exist）；品牌名统一 Crazyrouter）