Lỗi thường gặp và cách khôi phục
Ghi lại trạng thái HTTP và đường dẫn yêu cầu trước khi xử lý.
401 Chưa xác thực
Key bị thiếu, không hoạt động, sao chép thiếu hoặc gửi sai header xác thực.
Sao chép lại Key, bỏ khoảng trắng và kiểm tra Bearer, x-api-key hoặc x-goog-api-key theo giao thức.
403 Bị từ chối
Key hiện tại, trạng thái tài khoản hoặc quyền truy cập mô hình không cho phép yêu cầu.
Xác nhận Key còn hoạt động và chọn mô hình hiện có trên trang mô hình và giá.
404 Không tìm thấy
Base URL, đường dẫn giao thức hoặc phương thức HTTP không khớp; ứng dụng cũng có thể nối /v1 hai lần.
Đối chiếu phương thức và đường dẫn đầy đủ với hướng dẫn, chỉ nhập đúng cấp Base URL được nêu.
429 Quá nhiều yêu cầu
Yêu cầu quá dày hoặc số dư hiện có không đủ.
Giảm đồng thời, thử lại với khoảng chờ tăng dần và kiểm tra trạng thái tài khoản trên cổng.
5xx Lỗi dịch vụ
Dịch vụ phía trên hoặc gateway tạm thời không hoàn thành yêu cầu.
Lưu thời điểm và trạng thái rồi thử lại sau. Nếu tiếp diễn, dùng curl tối thiểu để loại trừ cấu hình ứng dụng.
Mất kết nối mạng
Mạng cục bộ, proxy hoặc kết nối dài bị đóng trước khi phản hồi hoàn tất.
Kiểm tra tên miền, kết nối lại stream với backoff và không tự động lặp thao tác không idempotent.
Nếu vẫn chưa khôi phục
Lưu thời điểm, giao thức, phương thức HTTP, đường dẫn, trạng thái và đoạn phản hồi đã che dữ liệu nhạy cảm. Không gửi toàn bộ Key.