Xử lý lỗi

Kiểm tra theo thứ tự

1. Xác nhận API origin là https://api.openaihub.net.
2. Kiểm tra công cụ có tự thêm /v1 hoặc API path không.
3. Xác nhận biến môi trường đã được đặt trong đúng tiến trình chạy ứng dụng.
4. Gọi GET /v1/models để kiểm tra xác thực và xem model truy cập được.
5. Xác nhận model hỗ trợ giao thức đang gọi; kiểm tra số dư/hạn mức trong bảng điều khiển.

HTTP 401 hoặc lỗi token

Key có thể thiếu, sai, bị thu hồi hoặc không có quyền. Kiểm tra header Bearer và khoảng trắng thừa. Không dùng cookie đăng nhập thay key. Lưu lại nội dung lỗi đã che thông tin nhạy cảm nếu vẫn thất bại.

HTTP 403

Có thể liên quan quyền truy cập, chính sách bảo mật hoặc lớp bảo vệ mạng. Không kết luận API key hỏng chỉ dựa vào mã này. Gửi CSKH thời điểm lỗi, API path và request ID nếu có.

HTTP 404 hoặc trả HTML

Kiểm tra nhầm domain website, sai route, /v1/v1 hoặc lặp /chat/completions. Một trang HTML trả HTTP 200 không phải phản hồi API thành công.

Model không khả dụng

So sánh chính xác model ID với kết quả /v1/models. Nếu có trong danh sách mà vẫn lỗi, kiểm tra giao thức và quyền nhóm tài khoản với CSKH. Không tự thay model trong tác vụ production.

HTTP 429, 5xx hoặc timeout

Đọc chi tiết lỗi trước khi thử lại. Với giới hạn tốc độ, giảm số yêu cầu đồng thời và dùng backoff có giới hạn nếu phù hợp. Với timeout, kiểm tra mạng và thời gian xử lý dự kiến.

Timeout không chứng minh yêu cầu chưa được xử lý. Không tự gửi lặp tác vụ dài hoặc có tính phí khi chưa xác nhận trạng thái.

Nhờ AI hoặc CSKH kiểm tra

Chuẩn bị tên công cụ, phiên bản, base URL, model, HTTP status, API path, thời điểm lỗi và request ID. Che API key, header Authorization, dữ liệu khách hàng và prompt nhạy cảm.

Liên hệ @muataikhoan_sp.