Hãy sử dụng hướng dẫn này để giúp bạn chẩn đoán và giải quyết các vấn đề thường gặp phát sinh khi bạn gọi Gemini API. Nếu bạn gặp phải các vấn đề về khoá API, hãy đảm bảo bạn đã thiết lập khoá API của bạn đúng cách theo hướng dẫn thiết lập khoá API.
Mã lỗi
Bảng sau đây liệt kê các mã lỗi phổ biến mà bạn có thể gặp phải, cùng với nội dung giải thích về nguyên nhân và các bước khắc phục vấn đề:
| Mã HTTP | Trạng thái | Nội dung mô tả | Giải pháp |
| 400 | Hàm INVALID_ARGUMENT | Nội dung yêu cầu không đúng định dạng. | Tham khảo tài liệu tham khảo API để biết định dạng yêu cầu, ví dụ và các phiên bản được hỗ trợ. Việc sử dụng các tính năng của phiên bản API mới hơn với điểm cuối cũ có thể gây ra lỗi. |
| 400 | FAILED_PRECONDITION | Bậc miễn phí của Gemini API hiện chưa có ở quốc gia của bạn. Vui lòng bật tính năng thanh toán cho dự án của bạn trong Google AI Studio. | Để sử dụng Gemini API, bạn sẽ cần thiết lập gói có tính phí bằng Google AI Studio. |
| 403 | PERMISSION_DENIED | Khoá API của bạn không có các quyền cần thiết. | Hãy kiểm tra để đảm bảo rằng bạn đã thiết lập khoá API và có quyền truy cập phù hợp. |
| 404 | NOT_FOUND | Không tìm thấy tài nguyên được yêu cầu. | Kiểm tra xem tất cả thông số trong yêu cầu của bạn có hợp lệ cho phiên bản API hay không. |
| 429 | RESOURCE_EXHAUSTED | Bạn đã vượt quá giới hạn tốc độ. | Đảm bảo rằng bạn nằm trong giới hạn tốc độ của mô hình. Yêu cầu tăng hạn mức nếu cần. |
| 500 | NỘI BỘ | Đã xảy ra lỗi không mong muốn ở phía Google. | Hãy đợi một chút rồi thử yêu cầu lại. Nếu vấn đề vẫn tiếp diễn sau khi thử lại, vui lòng báo cáo vấn đề bằng cách sử dụng nút Gửi ý kiến phản hồi trong Google AI Studio. |
| 503 | KHÔNG CÓ | Dịch vụ có thể tạm thời bị quá tải hoặc ngừng hoạt động. | Hãy đợi một chút rồi thử yêu cầu lại. Nếu vấn đề vẫn tiếp diễn sau khi thử lại, vui lòng báo cáo vấn đề bằng cách sử dụng nút Gửi ý kiến phản hồi trong Google AI Studio. |
Kiểm tra các lệnh gọi API để tìm lỗi tham số mô hình
Đảm bảo thông số mô hình của bạn nằm trong các giá trị sau:
| Thông số mô hình | Giá trị (dải_ô) |
| Số ứng cử viên | 1–8 (số nguyên) |
| Nhiệt độ | 0,0-1,0 |
| Mã thông báo đầu ra tối đa |
Sử dụng
get_model (Python)
để xác định số lượng mã thông báo tối đa cho mô hình mà bạn đang sử dụng.
|
| TopP | 0,0-1,0 |
Ngoài việc kiểm tra các giá trị thông số, hãy đảm bảo bạn đang sử dụng đúng giá trị
Phiên bản API (ví dụ: /v1 hoặc /v1beta) và
mô hình hỗ trợ các tính năng bạn cần. Ví dụ: nếu một tính năng đang trong giai đoạn thử nghiệm
bản phát hành này, thì sẽ chỉ có trong phiên bản API /v1beta.
Kiểm tra xem bạn có đúng kiểu máy hay không
Đảm bảo bạn đang sử dụng mô hình được hỗ trợ được liệt kê trên trang mô hình.
Vấn đề về an toàn
Nếu bạn thấy một lời nhắc đã bị chặn do chế độ cài đặt an toàn trong lệnh gọi API, xem lại lời nhắc liên quan đến các bộ lọc mà bạn đã thiết lập trong lệnh gọi API.
Nếu bạn thấy BlockedReason.OTHER, thì có thể câu hỏi hoặc câu trả lời đó vi phạm những điều khoản này
dịch vụ hoặc không được hỗ trợ.
Cải thiện đầu ra của mô hình
Để tạo ra mô hình chất lượng cao hơn, hãy tìm hiểu cách viết các câu lệnh có cấu trúc rõ ràng hơn. Chiến lược phát hành đĩa đơn giới thiệu trang giới thiệu về thiết kế lời nhắc một số khái niệm cơ bản, chiến lược và phương pháp hay nhất để giúp bạn bắt đầu.
Nếu có hàng trăm ví dụ về các cặp đầu vào/đầu ra phù hợp, bạn cũng có thể hãy cân nhắc việc điều chỉnh mô hình.
Tìm hiểu các hạn mức về mã thông báo
Đọc Hướng dẫn về mã thông báo của chúng tôi để hiểu rõ hơn về cách để đếm mã thông báo và giới hạn của mã.
Vấn đề đã biết
- API này chỉ hỗ trợ tiếng Anh. Việc gửi câu lệnh bằng nhiều ngôn ngữ có thể tạo ra phản hồi không mong muốn hoặc thậm chí bị chặn. Xem mục có sẵn ngôn ngữ để biết nội dung cập nhật.
Báo cáo lỗi
Tham gia cuộc thảo luận trên diễn đàn dành cho nhà phát triển AI của Google nếu bạn có thắc mắc.