跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt

Use this file to discover all available pages before exploring further.

HTTP 状态码

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

500 与 502 的区别

  • 500 是更宽泛的服务端错误。在 CrazyRouter 中,它既可能表示本站内部错误,也可能表示上游直接返回了 5xx,再由本站中继给客户端。
  • 502 更具体,通常表示请求已经到达 CrazyRouter 的网关或上游调用阶段,但 CrazyRouter 无法拿到有效的上游响应或结果,例如上游不可达、返回无效网关级响应,或任务结果地址取回失败。
  • 如果同类问题持续出现:
    • 大量 502 通常优先检查上游渠道可用性、网络连通性和结果 URL 是否可访问。
    • 大量 500 需要结合错误类型和日志进一步区分;只有明确标记为站内 site_internal 或 panic 一类时,才应直接视为 CrazyRouter 自身问题。

Chat Completions 状态码

{
  "error": {
    "message": "错误描述",
    "type": "error_type",
    "code": "error_code"
  }
}
code说明
invalid_api_keyAPI Key 无效或已过期
insufficient_quota余额不足
model_not_found模型不存在或未启用
context_length_exceeded输入超过模型上下文长度限制
rate_limit_exceeded请求频率超限
content_filter内容被安全过滤器拦截

Midjourney 任务状态码

状态说明
NOT_START任务未开始
SUBMITTED已提交
IN_PROGRESS生成中
SUCCESS生成成功
FAILURE生成失败
CANCEL已取消

MJ 错误码

code说明
1提交成功
21任务已存在
22排队中
23队列已满
24提交失败

Kling 视频状态码

状态说明
queued已提交或排队中
processing处理中
succeeded生成成功
failed生成失败

即梦任务状态码

状态说明
queued已提交或排队中
processing处理中
succeeded生成成功
failed生成失败

Luma 视频状态码

状态说明
pending等待中
processing处理中
completed完成
failed失败

Suno 音乐状态码

状态说明
submitted已提交
processing生成中
complete完成
error错误

Runway 视频状态码

状态说明
PENDING等待中
RUNNING生成中
SUCCEEDED成功
FAILED失败

通用错误处理建议

遇到 429 错误时,请勿立即重试。建议使用指数退避策略(Exponential Backoff),初始等待 1 秒,每次翻倍。
import time
import requests

def request_with_retry(url, headers, json_data, max_retries=3):
    for i in range(max_retries):
        response = requests.post(url, headers=headers, json=json_data)
        if response.status_code == 429:
            wait = 2 ** i
            print(f"频率限制,等待 {wait} 秒后重试...")
            time.sleep(wait)
            continue
        return response
    return response