Hướng dẫn khắc phục sự cố

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. Nhìn chung, bạn có thể gặp phải vấn đề do dịch vụ phụ trợ của Gemini API hoặc SDK ứng dụng. Các SDK khách hàng của chúng tôi là nguồn mở trong các kho lưu trữ sau:

Nếu bạn gặp phải các vấn đề về khoá API, hãy đảm bảo rằng 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 của dịch vụ phụ trợ Gemini API

Bảng sau đây liệt kê các mã lỗi phụ trợ phổ biến mà bạn có thể gặp phải, cùng với kèm theo lời giải thích cho 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ả Ví dụ Giải pháp
400 INVALID_ARGUMENT Nội dung yêu cầu không đúng định dạng. Có lỗi đánh máy hoặc thiếu trường bắt buộc trong yêu cầu của bạn. 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. Bạn đang đưa ra yêu cầu ở một khu vực không hỗ trợ cấp miễn phí và chưa bật tính năng thanh toán cho dự án của mình 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. Bạn đang sử dụng khoá API không chính xác; bạn đang cố sử dụng một mô hình được điều chỉnh mà không qua bước xác thực thích hợp. 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. Bạn cũng cần đảm bảo trải qua quy trình xác thực thích hợp để sử dụng các mô hình đã được điều chỉnh.
404 NOT_FOUND Không tìm thấy tài nguyên được yêu cầu. Không tìm thấy tệp hình ảnh, âm thanh hoặc video được tham chiếu trong yêu cầu của bạn. 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 độ. Bạn đang gửi quá nhiều yêu cầu mỗi phút bằng API Gemini cấp miễn phí. Đả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. Ngữ cảnh nhập của bạn quá dài. Giảm ngữ cảnh nhập hoặc tạm thời chuyển sang một mô hình khác (ví dụ: từ Gemini 1.5 Pro sang Gemini 1.5 Flash) và xem nó có hoạt động hay không. Hoặc bạn có thể đợi một lúc 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 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. Dịch vụ tạm thời hết dung lượng. Tạm thời chuyển sang một mô hình khác (ví dụ: từ Gemini 1.5 Pro sang Gemini 1.5 Flash) và xem nó có hoạt động hay không. Hoặc bạn có thể đợi một lúc 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.
504 DEADLINE_EXCEEDED Dịch vụ không thể hoàn tất quá trình xử lý trong thời hạn. Câu lệnh (hoặc ngữ cảnh) của bạn quá lớn nên chúng tôi không thể xử lý kịp thời. Đặt 'thời gian chờ' lớn hơn trong yêu cầu của máy khách để tránh lỗi này.

Mã lỗi SDK ứng dụng Python

Bảng sau đây liệt kê các chỉ số phổ biến Lỗi SDK ứng dụng Python các mã bạn có thể gặp phải, cùng với phần giải thích cho nguyên nhân gây ra chúng:

Loại ngoại lệ/lỗi Lớp Mô tả
BlockedPromptException google.generativeai.types.BlockedPromptException Lời nhắc đã bị chặn vì lý do an toàn.
BrokenResponseError google.generativeai.types.BrokenResponseError Phản hồi truyền trực tuyến bị lỗi. Được nâng lên khi truy cập vào nội dung nào đó yêu cầu trả lời đầy đủ, chẳng hạn như nhật ký trò chuyện. Xem thông tin chi tiết về lỗi được cung cấp trong dấu vết ngăn xếp.
IncompleteIterationError google.generativeai.types.IncompleteIterationError Được nâng lên khi truy cập nội dung yêu cầu phản hồi API hoàn chỉnh, nhưng phản hồi truyền trực tuyến chưa được lặp lại đầy đủ. Gọi resolve() trên đối tượng phản hồi để sử dụng trình lặp.
StopCandidateException google.generativeai.types.StopCandidateException API đã phản hồi bằng một finish_reason đặc biệt. Hãy xem lý do để nhận lời khuyên về cách tiếp tục.
PermissionDenied google.api_core.exceptions.PermissionDenied Bạn không có quyền đối với tài nguyên được yêu cầu (ví dụ: mô hình).
ResourceExhausted google.api_core.exceptions.ResourceExhausted Hạn mức của bạn đã hết. Vui lòng chờ một lát rồi thử lại. Hãy cân nhắc việc thiết lập tính năng thử lại tự động để xử lý những lỗi này.
AlreadyExists google.api_core.exceptions.AlreadyExists Đã tồn tại một mô hình được điều chỉnh có cùng mã nhận dạng. Vui lòng chỉ định ID kiểu máy duy nhất khi điều chỉnh mô hình mới.
InvalidArgument google.api_core.exceptions.InvalidArgument Đối số không hợp lệ. Một ví dụ là tệp quá lớn và vượt quá giới hạn kích thước tải trọng. Một phương thức khác đang cung cấp khoá API không hợp lệ.
DefaultCredentialsError google.auth.exceptions.DefaultCredentialsError Không xác thực được. Vui lòng kiểm tra kỹ khoá API của bạn rồi thử lại.
RetryError google.api_core.exceptions.RetryError Điều này có thể xảy ra khi sử dụng proxy không hỗ trợ gRPC. Hãy thử dùng công cụ di chuyển REST với genai.configure(..., transport="rest").

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ợ.

Vấn đề về việc trích dẫn

Nếu bạn thấy mô hình ngừng tạo đầu ra vì lý do RECITATION, thì đây là nghĩa là đầu ra mô hình có thể giống với một số dữ liệu nhất định. Để khắc phục vấn đề này, hãy cố gắng lời nhắc / bối cảnh càng độc đáo càng tốt và sử dụng nhiệt độ càng cao.

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ợ một số ngôn ngữ chọn lọc. Gửi câu lệnh bằng ngôn ngữ không được hỗ trợ có thể tạo ra phản hồi không mong muốn hoặc thậm chí bị chặn. Xem các ngôn ngữ được hỗ trợ để 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.