LIÊN HỆ HOTLINE/ZALO: 0981.243.678
Khắc phục sự cố về giới hạn sử dụng và giới hạn chi tiêu API
Xác định giới hạn hoặc số dư tín dụng đang ảnh hưởng đến các yêu cầu API của bạn và tìm bước xử lý phù hợp tiếp theo.
Tổng quan
Lỗi thanh toán hoặc hạn ngạch API có thể có nghĩa là bạn đã đạt giới hạn sử dụng được phê duyệt, đạt giới hạn chi tiêu đã cấu hình hoặc đã dùng hết tín dụng trả trước. Hãy kiểm tra lỗi trước khi thay đổi cài đặt.
Xác định lỗi
Kiểm tra error.code trong phản hồi API. Lỗi liên quan đến thanh toán vẫn có thể dùng giá trị error.type tổng quát hơn là insufficient_quota.
| Mã lỗi | Ý nghĩa | Bước tiếp theo |
| organization_usage_limit_exceeded | Tổ chức của bạn đã đạt giới hạn sử dụng do OpenAI chỉ định. | Xem lại giới hạn được phê duyệt và các lựa chọn để tăng giới hạn. |
| organization_spend_limit_exceeded | Tổ chức của bạn đã đạt giới hạn chi tiêu cứng đã cấu hình. | Xem lại các tùy chọn kiểm soát chi tiêu của tổ chức. |
| project_spend_limit_exceeded | Dự án của bạn đã đạt giới hạn chi tiêu cứng đã cấu hình. | Xem lại các tùy chọn kiểm soát chi tiêu của dự án đó. |
| credit_balance_exhausted | Tổ chức của bạn không còn tín dụng trả trước. | Nạp thêm tín dụng vào số dư API. |
Thử lại các lỗi này sẽ không khôi phục quyền truy cập nếu bạn chưa xử lý vấn đề về tín dụng hoặc giới hạn liên quan. Để biết chi tiết, xem hướng dẫn về mã lỗi API.
Xem lại giới hạn sử dụng được phê duyệt
Truy cập trang Giới hạn (Limits) của tổ chức để kiểm tra giới hạn sử dụng hằng tháng hiện được phê duyệt và cấp sử dụng (usage tier).
Các cấp sử dụng API trả phí gồm Build, Launch và Grow. Tổ chức của bạn được tự động nâng cấp khi tổng số tín dụng đã mua lần lượt đạt $5, $100 và $500. Cấp cao hơn thường có giới hạn tốc độ cao hơn. Hãy kiểm tra trang Giới hạn của tổ chức để biết cấp và các giới hạn hiện tại.
Các tổ chức trả phí hiện có được tự động chuyển từ Cấp 1–2 sang Build, từ Cấp 3–4 sang Launch và từ Cấp 5 sang Grow. Bạn không cần thanh toán thêm cho lần chuyển đổi này. Giá API và giới hạn tốc độ tùy chỉnh không thay đổi.
Để biết chi tiết về các cấp, xem hướng dẫn về giới hạn tốc độ API.
Kiểm tra các tùy chọn kiểm soát chi tiêu đã cấu hình
Cảnh báo chi tiêu chỉ gửi thông báo mà không dừng lưu lượng API. Giới hạn chi tiêu cứng có thể chặn các yêu cầu bị ảnh hưởng khi mức chi tiêu được ghi nhận đạt đến số tiền đã cấu hình.
Cả giới hạn của tổ chức và của dự án đều có thể được áp dụng. Giới hạn của tổ chức bao trùm các dự án trong tổ chức; giới hạn của dự án áp dụng cho lưu lượng được tính phí vào dự án đó. Các tùy chọn kiểm soát này tách biệt với giới hạn sử dụng do OpenAI phê duyệt.
Nếu lỗi do giới hạn cứng gây ra, người có quyền quản lý các cài đặt liên quan có thể tăng hoặc gỡ bỏ giới hạn nếu cần tiếp tục chi tiêu. Nếu không, giới hạn sẽ được đặt lại vào chu kỳ hằng tháng tiếp theo. Việc thay đổi và áp dụng giới hạn không diễn ra tức thì, vì vậy mức chi tiêu được ghi nhận có thể vượt số tiền đã cấu hình một chút.
Để biết các cài đặt và hướng dẫn, xem hướng dẫn về giới hạn chi tiêu API.
Kiểm tra số dư trả trước
Nếu bạn đã dùng hết tín dụng trả trước, hãy truy cập cổng thanh toán API và chọn Buy credits hoặc Add to credit balance (tùy nút nào xuất hiện) để mua thêm. Số dư cập nhật có thể mất vài phút mới hiển thị.
Để được hướng dẫn thiết lập và nạp lại, xem: Thiết lập thanh toán trả trước.
Kiểm tra xem lỗi có phải do giới hạn tốc độ không
Giới hạn tốc độ theo yêu cầu và theo token kiểm soát tốc độ bạn có thể sử dụng API. Các giới hạn này khác với giới hạn sử dụng hằng tháng, tùy chọn kiểm soát chi tiêu và số dư trả trước.
Với lỗi giới hạn tốc độ theo yêu cầu hoặc theo token, xem: Khắc phục lỗi giới hạn tốc độ API.
Nếu sự cố vẫn tiếp diễn
Trước khi chuyển lên cấp hỗ trợ cao hơn
Hãy chuẩn bị sẵn thông báo lỗi và mã lỗi, thời điểm xảy ra lỗi kèm múi giờ của bạn và mọi ID yêu cầu (request ID) liên quan. Xóa thông tin nhạy cảm khỏi ảnh chụp màn hình hoặc đoạn mã bạn chia sẻ.
Liên hệ Bộ phận hỗ trợ OpenAI
Nếu nhu cầu của bạn vượt quá các giới hạn dành cho tổ chức, bạn có trường hợp sử dụng đặc thù hoặc lỗi vẫn tiếp diễn sau khi đã xử lý nguyên nhân, hãy liên hệ Bộ phận hỗ trợ OpenAI bằng tiện ích trò chuyện trong Trung tâm trợ giúp.
Để biết cách liên hệ và những thông tin cần cung cấp, xem: Liên hệ Bộ phận hỗ trợ.

Liên hệ qua Zalo