跳转到主要内容

HTTP 状态码

状态码说明处理建议
200请求成功-
400请求参数错误检查请求体格式和参数
401认证失败检查 API Key 是否正确
403权限不足检查令牌是否有权限访问该模型
404资源不存在检查 URL 路径
429请求频率超限降低请求频率或联系管理员
500服务器内部错误稍后重试
502上游服务错误上游渠道异常,系统会自动重试
503服务不可用系统维护中

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 视频状态码

状态说明
submitted已提交
processing处理中
succeed生成成功
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