Mã lỗi

Lỗi 400: API key not valid. Please pass a valid API key.

Nếu bạn nhận được lỗi 400 có nội dung API key not valid. Please pass a valid API key., thì thường là do khoá API trong tệp/đối tượng cấu hình Firebase của bạn không tồn tại hoặc chưa được thiết lập để sử dụng với ứng dụng và/hoặc dự án Firebase của bạn.

Hãy kiểm tra để đảm bảo rằng khoá API được liệt kê trong tệp/đối tượng cấu hình Firebase của bạn khớp với khoá API của ứng dụng. Bạn có thể xem tất cả khoá API trong API và Dịch vụ > Thông tin xác thực trong bảng điều khiển Google Cloud.

Nếu phát hiện thấy các khoá này không khớp, hãy lấy một tệp/đối tượng cấu hình Firebase mới, rồi thay thế tệp/đối tượng trong ứng dụng của bạn. Tệp/đối tượng cấu hình mới phải chứa một khoá API hợp lệ cho ứng dụng và dự án Firebase của bạn.

Lỗi 400: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Nếu đang cố gắng gửi một yêu cầu đa phương thức bằng Cloud Storage for Firebase URL, bạn có thể gặp lỗi 400 sau:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Lỗi này xảy ra do một dự án không có các tác nhân dịch vụ bắt buộc được tự động cung cấp đúng cách khi Vertex AI API được bật trong dự án. Đây là một vấn đề đã biết đối với một số dự án và chúng tôi đang nỗ lực khắc phục trên toàn cầu.

Sau đây là giải pháp thay thế để khắc phục dự án và cung cấp đúng cách các tác nhân dịch vụ này để bạn có thể bắt đầu đưa URL Cloud Storage for Firebase vào các yêu cầu đa phương thức. Bạn phải là Chủ sở hữu dự án và chỉ cần hoàn thành bộ nhiệm vụ này một lần cho dự án của mình.

1. Truy cập và xác thực bằng gcloud CLI.
   Cách dễ nhất để thực hiện việc này là thông qua Cloud Shell. Tìm hiểu thêm trong tài liệu về Google Cloud.

2. Nếu được nhắc, hãy làm theo hướng dẫn xuất hiện trong thiết bị đầu cuối để gcloud CLI chạy trên dự án Firebase của bạn.

   Bạn sẽ cần mã dự án Firebase. Bạn có thể tìm thấy mã này ở đầu phần settings Cài đặt dự án trong bảng điều khiển Firebase.

3. Cung cấp các tác nhân dịch vụ bắt buộc trong dự án bằng cách chạy lệnh sau:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. Đợi vài phút để đảm bảo các tác nhân dịch vụ được cung cấp, rồi thử lại việc gửi yêu cầu đa phương thức có chứa Cloud Storage for Firebase URL.

Nếu bạn vẫn gặp lỗi này sau khi đợi vài phút, hãy liên hệ với Nhóm hỗ trợ Firebase.

Lỗi 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Nếu bạn nhận được lỗi 403 có nội dung Requests to this API firebasevertexai.googleapis.com ... are blocked., thì thường là do khoá API trong cấu hình Firebase trong ứng dụng của bạn có các quy tắc hạn chế ngăn khoá này gọi API bắt buộc.

Để khắc phục vấn đề này, bạn cần cập nhật các quy tắc hạn chế của khoá API trong Google Cloud bảng điều khiển để đưa API bắt buộc vào. Đối với Firebase AI Logic, bạn phải đảm bảo rằng Firebase AI Logic API (firebasevertexai.googleapis.com) được đưa vào danh sách các API đã chọn có thể được gọi bằng khoá API.

Hãy làm theo các bước sau:

1. Trong bảng điều khiển Google Cloud, hãy mở bảng điều khiển API và Dịch vụ > Thông tin xác thực.

2. Chọn khoá API mà ứng dụng của bạn được định cấu hình để sử dụng (ví dụ: "khoá iOS" cho ứng dụng iOS).

3. Trên trang Chỉnh sửa khoá API, hãy tìm phần Quy tắc hạn chế đối với API.

4. Đảm bảo bạn đã chọn tuỳ chọn Hạn chế khoá. Nếu không, khoá của bạn sẽ không bị hạn chế và đây có thể không phải là nguồn gốc của lỗi.

5. Trong trình đơn thả xuống API đã chọn, hãy tìm và chọn Firebase AI Logic API để thêm API này vào danh sách các API đã chọn có thể được gọi bằng khoá API.

6. Nhấp vào Lưu.

   Có thể mất tối đa 5 phút để các thay đổi có hiệu lực.

Lỗi 403: PERMISSION_DENIED: The caller does not have permission.

Nếu bạn nhận được lỗi 403 có nội dung PERMISSION_DENIED: The caller does not have permission., thì thường là do khoá API trong tệp/đối tượng cấu hình Firebase của bạn thuộc về một dự án Firebase khác.

Hãy kiểm tra để đảm bảo rằng khoá API được liệt kê trong tệp/đối tượng cấu hình Firebase của bạn khớp với khoá API của ứng dụng. Bạn có thể xem tất cả khoá API trong API và Dịch vụ > Thông tin xác thực trong bảng điều khiển Google Cloud.

Nếu phát hiện thấy các khoá này không khớp, hãy lấy một tệp/đối tượng cấu hình Firebase mới, rồi thay thế tệp/đối tượng trong ứng dụng của bạn. Tệp/đối tượng cấu hình mới phải chứa một khoá API hợp lệ cho ứng dụng và dự án Firebase của bạn.

Lỗi 404: Firebase AI Logic genai config not found

Nếu đang cố gắng sử dụng Gemini Developer API và bạn nhận được lỗi 404 có nội dung Firebase AI Logic genai config not found, thì thường là do dự án Firebase của bạn không có khoá Gemini API hợp lệ để sử dụng với Firebase AI Logic SDK của máy khách.

Sau đây là những nguyên nhân có thể gây ra lỗi này:

• Bạn chưa thiết lập dự án Firebase cho Gemini Developer API.

  Việc cần làm:
  Trong bảng điều khiển Firebase, hãy chuyển đến Dịch vụ AI > AI Logic. Nhấp vào Bắt đầu, rồi chọn Gemini Developer API. Bật API này và bảng điều khiển sẽ thiết lập dự án của bạn cho Gemini Developer API. Sau khi hoàn tất quy trình làm việc, hãy thử lại yêu cầu của bạn.

• Nếu bạn vừa thực hiện quy trình thiết lập Firebase AI Logic trong bảng điều khiển Firebase, thì khoá Gemini API có thể chưa được cung cấp cho tất cả các dịch vụ phụ trợ bắt buộc ở tất cả các khu vực.

  Việc cần làm:
  Đợi vài phút, rồi thử lại yêu cầu của bạn.

• Khoá API của bạn có thể đã bị xoá khỏi dự án Firebase.Gemini

  Việc cần làm:
  Tìm hiểu cách thay đổi khoá Gemini API mà Firebase AI Logic sử dụng.

Lỗi 404: mô hình "was not found or your project does not have access to it"?

Ví dụ: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version." (Không tìm thấy dự án Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-preview hoặc dự án của bạn không có quyền truy cập vào dự án này. Vui lòng đảm bảo bạn đang sử dụng phiên bản mô hình hợp lệ.)

Có một số lý do khiến bạn có thể gặp lỗi như thế này.

• Tên mô hình không hợp lệ

  • Nguyên nhân: Tên mô hình bạn cung cấp không phải là tên mô hình hợp lệ.

  • Cách khắc phục: Kiểm tra tên mô hình và phiên bản mô hình của bạn dựa trên danh sách tất cả các mô hình được hỗ trợ và có sẵn. Hãy nhớ kiểm tra các phân đoạn và thứ tự của chúng trong tên mô hình. Ví dụ:

    • Tên mô hình mới nhất: gemini-3.1-pro-preview (chỉ có ở bản dùng thử)Gemini 3.x Pro
    • Tên mô hình Gemini 3.x Flash mới nhất: gemini-3.5-flash
    • Tên mô hình mới nhất: gemini-3.1-flash-liteGemini 3.x Flash‑Lite
    • Tên mô hình Gemini 3.x Pro Image (còn gọi là "Nano Banana Pro") mới nhất: gemini-3-pro-image-preview (chỉ có ở bản dùng thử)
    • Gemini 3.x Flash Image mới nhất (còn gọi là "Nano Banana 2") tên mô hình: gemini-3.1-flash-image-preview (chỉ có ở bản dùng thử)
    • Tên mô hình "Nano Banana" mới nhất: gemini-2.5-flash-image

• Vị trí không hợp lệ (chỉ áp dụng nếu sử dụng nhà cung cấp Vertex AI Gemini API)

  • Nguyên nhân: Mỗi yêu cầu sử dụng Vertex AI Gemini API phải bao gồm vị trí để truy cập vào mô hình. Yêu cầu của bạn có thể đang cố gắng truy cập vào một mô hình ở vị trí mà mô hình đó không có sẵn.

  • Cách khắc phục: Đảm bảo yêu cầu của bạn đang cố gắng truy cập vào mô hình ở vị trí mà mô hình đó có sẵn.

    Khi sử dụng Vertex AI Gemini API, Firebase AI Logic mặc định là us-central1. Tuy nhiên, không phải mô hình nào cũng được hỗ trợ trong us-central1. Điều này có nghĩa là tuỳ thuộc vào mô hình, bạn có thể cần đặt một vị trí cụ thể một cách rõ ràng trong quá trình khởi chạy.

    • Gemini dùng thử và thử nghiệm models: Setting the location to global is required (except for Live API models). Tất cả các mô hình dùng thử và thử nghiệm Gemini (ngoại trừ các Live API mô hình) chỉ có ở vị trí global.

    • Gemini 3.x mô hình: Bạn phải đặt vị trí thành global khi sử dụng Firebase AI Logic. Firebase AI Logic chưa hỗ trợ các vị trí us và eu.

    • Gemini 2.5 mô hình: Bạn có thể đặt vị trí. Nếu bạn không chỉ định vị trí, thì vị trí mặc định là us-central1.

    • Gemini Live API mô hình: Đặt vị trí là tùy chọn. Nếu bạn không chỉ định vị trí, thì vị trí mặc định là us-central1. Xin lưu ý rằng vị trí global không được hỗ trợ.

  Tìm hiểu thêm về cách chỉ định vị trí để truy cập vào mô hình (bao gồm cả đoạn mã).

Lỗi 429: "You exceeded your current quota, please check your plan and billing details" hoặc "Resource exhausted, please try again later."

Lỗi 429 cho biết bạn đang vượt quá hạn mức hoặc mô hình mà bạn đang truy cập bị quá tải do các yêu cầu của người khác.

Bạn cần thực hiện hành động tuỳ thuộc vào việc bạn đang sử dụng Gemini Developer API hay Vertex AI Gemini API. Để biết thêm thông tin về hạn mức và cách yêu cầu hạn mức bổ sung, hãy xem bài viết Hạn mức và hạn ngạch.

Nếu bạn đang sử dụng Vertex AI Gemini API, tài liệu Google Cloud sẽ cung cấp thêm bối cảnh và hướng dẫn cho Mã lỗi 429.