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 API Gemini. Nếu bạn gặp các vấn đề về khoá API, hãy đảm bảo rằng bạn đã thiết lập khoá API đú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 sự cố:
| Mã HTTP | Trạng thái | Nội dung mô tả | Giải pháp |
| 400 | INVALID_ARGUMENT | Nội dung yêu cầu không đúng định dạng. | Xem tài liệu tham khảo API để biết định dạng yêu cầu, ví dụ và 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 với điểm cuối cũ có thể gây ra lỗi. |
| 403 | PERMISSION_DENIED | Khoá API của bạn không có các quyền cần thiết. | Kiểm tra để đảm bảo khoá API đã được đặt 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ả tham số trong yêu cầu của bạn có hợp lệ cho phiên bản API của bạn hay không. |
| 429 | RESOURCE_EXHAUSTED | Bạn đã vượt quá giới hạn tốc độ. | Đảm bảo bạn không vượt quá giới hạn số lượng yêu cầu 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ử lại yêu cầu của bạn. Nếu vấn đề vẫn tiếp diễn sau khi thử lại, vui lòng báo cáo vấn đề này bằng cách sử dụng nút Gửi 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ử lại yêu cầu của bạn. Nếu vấn đề vẫn tiếp diễn sau khi thử lại, vui lòng báo cáo vấn đề này bằng cách sử dụng nút Gửi phản hồi trong Google AI Studio. |
Kiểm tra lệnh gọi API để tìm lỗi tham số mô hình
Đảm bảo rằng thông số của mô hình nằm trong các giá trị sau:
| Thông số mô hình | Giá trị (dải_ô) |
| Số lượng ứng 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ị tham số, hãy đảm bảo rằng bạn đang sử dụng đúng phiên bản API (ví dụ: /v1 hoặc /v1beta) và mô hình hỗ trợ các tính năng mà bạn cần. Ví dụ: nếu một tính năng đang trong bản phát hành Beta, thì tính năng đó sẽ chỉ có trong phiên bản API /v1beta.
Kiểm tra xem bạn có kiểu máy phù hợp không
Đảm bảo bạn đang sử dụng kiểu máy được hỗ trợ. Hãy sử dụng list_models (Python) để lấy tất cả các mô hình có thể sử dụng.
Vấn đề an toàn
Nếu bạn thấy lời nhắc bị chặn do một chế độ cài đặt an toàn trong lệnh gọi API, hãy xem lại lời nhắc đó liên quan đến các bộ lọc bạn đã đặt trong lệnh gọi API.
Nếu bạn thấy BlockedReason.OTHER, thì truy vấn hoặc phản hồi đó có thể vi phạm điều khoản dịch vụ hoặc không được hỗ trợ.
Cải thiện đầu ra của mô hình
Để có kết quả mô hình chất lượng cao hơn, hãy tìm hiểu cách viết thêm câu lệnh có cấu trúc. Trang giới thiệu về thiết kế lời nhắc giới thiệu 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ể cân nhắc việc điều chỉnh mô hình.
Tìm hiểu về hạn mức của mã thông báo
Hãy sử dụng API ModelService để nhận siêu dữ liệu bổ sung về các mô hình, bao gồm cả giới hạn mã thông báo đầu vào và đầu ra.
Để nhận mã thông báo mà câu lệnh của bạn sử dụng, hãy sử dụng countMessageTokens cho mô hình trò chuyện và countTextTokens cho mô hình văn bản.
Vấn đề đã biết
- Hỗ trợ Google AI Studio trên thiết bị di động: Mặc dù bạn có thể mở trang web bằng thiết bị di động, nhưng trang web chưa được tối ưu hoá cho màn hình nhỏ.
- API chỉ hỗ trợ tiếng Anh. Việc gửi lời nhắc 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í là bị chặn. Hãy xem các ngôn ngữ được hỗ trợ để biết thông tin cập nhật.
Báo cáo lỗi
Gửi vấn đề trong GitHub để đặt câu hỏi hoặc gửi yêu cầu về tính năng hoặc lỗi.