Mã lỗi

Mọi lỗi — validate, billing, upstream — dùng một envelope mà SDK OpenAI vốn đã parse được. Cùng một request hỏng luôn nhận cùng một lỗi, nên logic retry tin được thứ nó đọc.

Envelope

{
  "error": {
    "message": "max_tokens (32768) exceeds the limit for your organization (16384).",
    "type": "invalid_request_error",
    "param": "max_tokens",
    "code": "max_tokens_exceeds_cap",
    "metadata": {}
  }
}

• type — taxonomy ổn định để rẽ nhánh (khớp bảng dưới).
• code — mã chi tiết cho máy xử lý.
• param — trường gây lỗi, khi xác định được.
• metadata — dữ liệu phụ ở một số lỗi, ví dụ số dư khả dụng trong lỗi 402.

Toàn bộ mã lỗi

Lỗi giữa stream

Stream đã bắt đầu thì HTTP đã là 200 — lỗi đến dưới dạng chunk cuối mang finish_reason: "error" kèm đúng envelope này trong trường error. Mẫu và code bắt lỗi: Streaming.

Hướng dẫn retry

• Retry có giãn cách: request_timeout, upstream_error, no_capacity, và các 429 kèm retry-after — SDK OpenAI vốn tự làm.
• Sửa rồi mới gửi lại: mọi 400/401/403/404/413/422 — vấn đề nằm ở chính request.
• Hành động thay vì retry: insufficient_credits (nạp tiền) và daily_budget_exceeded (nâng trần hoặc chờ 00:00 UTC).

Bắt lỗi 402 trong code của bạn

SDK OpenAI không có exception class riêng cho 402 — nó hiện ra dưới dạng APIStatusError chung (Python) / APIError (Node), nên handler chỉ viết cho RateLimitError hay AuthenticationError sẽ bỏ lọt. Rẽ nhánh theo status hoặc error.code:

# Python
import openai
try:
    resp = client.chat.completions.create(...)
except openai.APIStatusError as e:
    if e.status_code == 402:
        print("Hết credit:", e.body["error"]["message"])  # có sẵn số dư + link nạp
    else:
        raise

// Node
try {
  const resp = await client.chat.completions.create({...});
} catch (err) {
  if (err instanceof OpenAI.APIError && err.status === 402) {
    console.error('Hết credit:', err.error?.message);
  } else throw err;
}