错误和限制

GetVibe 在/v1/*上产生的错误包含一个 JSON 信封，其中有error.message、error.type和error.code。不要依赖消息文本或第三方服务标头作为契约。

{
  "error": {
    "message": "insufficient balance",
    "type": "insufficient_quota",
    "code": 402,
    "request_id": "8d4b6b3a-..."
  }
}

每个请求错误都包含下表中一个固定的 error.code、指明相关字段的 error.param（模型未指明字段时为 null），以及位于 error.message 末尾、指向对应表格行的链接——Codex 和其他 CLI 只显示消息，因此链接放在消息中。

慢速流（stream: true）在静默 5 秒后会获得 200 和 : pv-keepalive 注释，以免连接看起来已经失效；长时间运行的非流式请求会在收到首个令牌后获得 200 和空白字符。此后状态无法更改，错误会出现在响应正文中。如果你的客户端在 HTTP 错误时回退到另一个供应商，请发送 x-pv-honest-errors: 1（或联系支持团队为账户启用该选项）：这样便不会有 keepalive，也不会在收到首个响应字节之前提前返回 200；每次失败都会是带有 JSON 正文的普通 HTTP 状态。代价是，在收到首个令牌之前 socket 会保持静默；你的 header 超时设置必须覆盖这段时间。

响应开始后发生的错误是一个终止事件：对于聊天请求，使用 event: error，随后为 {"error":{message,type,code,status},"choices":[{"finish_reason":"error"}]} 和 data: [DONE]；对于 /v1/responses，使用携带相同 error 的 event: response.failed；对于 /v1/messages，使用 Anthropic 的 event: error。code 是机器可读的原因，status 是响应开始前该错误本应具有的 HTTP 状态。

这两项限制均取决于账户的当前余额，并由该账户的所有 API 密钥共同使用。等级会自动重新计算：充值后限额提高；余额低于某个阈值时等级降低。不设每分钟 token 数（TPM）限制。

对于可重试的响应，首先使用 Retry-After（如果存在）。如果没有该标头，不要将任何 429 或 503 自动视为可重试：请检查 HTTP 状态和公开的 error.type，修复不可重试的原因，并且仅对瞬时错误使用有界退避。

import time, requests

def call_with_retry(url, headers, payload, max_retries=5):
    for attempt in range(max_retries):
        r = requests.post(url, headers=headers, json=payload)
        if r.status_code == 429:
            # honor Retry-After, otherwise exponential backoff
            wait = int(r.headers.get("Retry-After", 2 ** attempt))
            time.sleep(wait)
            continue
        return r
    return r