错误码 - VibeToken

响应结构

/v1/*（OpenAI 兼容）：

{ "error": { "type": "invalid_request_error", "message": "...", "code": 400 } }

控制台 / 内部接口：

{ "code": 401, "message": "..." }

如何定位一次失败的请求

每个响应都会返回 x-request-id 响应头，JSON 错误响应体中也会带上同样的值，字段名为 request_id。反馈问题时请附上这个 ID：它是从海量调用中定位到这一次请求的唯一依据。

x-request-id: 0f2e2a7c-5a4f-4f0e-9a4a-0f4b9b9f2b11

{ "code": 400, "message": "...", "request_id": "0f2e2a7c-5a4f-4f0e-9a4a-0f4b9b9f2b11" }

单模型的 chat completion 请求中，这个 ID 同时也是该次生成的 ID，因此成功响应体里的 id 就是 gen-<x-request-id>。模型数组会为每一路生成单独的记录，此时响应头标识整次请求，每一路各自保留自己的 ID。

HTTP 状态码

Code	Name	Meaning
`200`	OK
`400`	Bad Request	参数无效或生成仍在处理中
`401`	Unauthorized	缺少 API key 或 API key 无效
`402`	Insufficient Credits	余额不足
`404`	Not Found	未知的端点或资源
`422`	Validation Error	请求体未通过 schema 校验
`429`	Rate Limited	退避后重试
`455`	Service Unavailable	维护中或上游服务中断
`500`	Server Error	内部错误
`501`	Generation Failed	模型已接受请求但未产生任何输出
`505`	Feature Disabled	端点已禁用

`error_code` 取值

一组稳定、更细粒度的类别，会设置在每一次失败的生成上。可从 GET /logs 读取（每行的 error_code 字段）。命名遵循 OpenAI 的 error.code 约定。

`error_code`	HTTP	Retry?	Fix
`insufficient_quota`	402, 455	否	前往 /billing 充值
`content_policy_violation`	400	否	改写提示词或更换输入图像
`rate_limit_exceeded`	429	是	指数退避
`timeout`	455	是	重新提交；上游可能已完成
`provider_unavailable`	455	是	暂时性问题 — 稍后重试
`invalid_request_error`	400	否	修正参数
`server_error`	500	是	重试；若持续出现请联系支持
`internal_error`	500	是	重试；若可复现请上报

重试分类

RETRYABLE_CODES = {
    "rate_limit_exceeded",
    "timeout",
    "provider_unavailable",
    "server_error",
    "internal_error",
}

def should_retry(error_code: str | None, http_status: int) -> bool:
    if error_code in RETRYABLE_CODES:
        return True
    return http_status == 429 or http_status >= 500

退避示例

import time, requests

def post_with_retry(url, headers, body, max_retries=5):
    for attempt in range(max_retries):
        res = requests.post(url, headers=headers, json=body)
        if res.status_code < 429 or (res.status_code != 429 and res.status_code < 500):
            return res
        time.sleep(2 ** attempt)
    raise RuntimeError("max retries exceeded")