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. (Khoá API không hợp lệ. Vui lòng truyền một khoá API hợp lệ.), thì điều này thường có nghĩa là khoá API trong tệp/đối tượng cấu hình Firebase 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.

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 khớp với khoá API cho ứng dụng của bạn. Bạn có thể xem tất cả khoá API trong bảng điều khiển API và Dịch vụ > Thông tin xác thực trong Google Cloud console.

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 phải lỗi 400 sau:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

Lỗi này là 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 tìm cách 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 Google Cloud.

2. Nếu được nhắc, hãy làm theo hướng dẫn hiển thị trong thiết bị đầu cuối để chạy gcloud CLI 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 cài đặt 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. Chờ vài phút để đảm bảo rằng các tác nhân dịch vụ được cung cấp, sau đó thử lại việc gửi yêu cầu đa phương thức có chứa URL.Cloud Storage for Firebase

Nếu bạn vẫn gặp lỗi này sau khi chờ 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. (Các yêu cầu gửi đến API firebasevertexai.googleapis.com ... bị chặn.), thì điều này thường có nghĩa là 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 console để đư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 Google Cloud console, 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 API restrictions (Quy tắc hạn chế đối với API).

4. Đảm bảo bạn đã chọn tuỳ chọn Restrict key (Hạn chế khoá). Nếu chưa chọn, thì khoá của bạn 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 Selected APIs, hãy tìm kiế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 đến 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ì điều này thường có nghĩa là khoá API trong tệp/đối tượng cấu hình Firebase thuộc về một dự án Firebase khác.

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 khớp với khoá API cho ứng dụng của bạn. Bạn có thể xem tất cả khoá API trong bảng điều khiển API và Dịch vụ > Thông tin xác thực trong Google Cloud console.

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 bạn đang cố gắng sử dụng Gemini Developer API và nhận được lỗi 404 có nội dung Firebase AI Logic genai config not found, thì điều này thường có nghĩa là dự án Firebase của bạn không có khoá Gemini API hợp lệ để sử dụng với Firebase AI Logic client SDK.

Dưới đây là những nguyên nhân có khả năng gây ra lỗi này nhất:

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

  Cách xử lý:
  Trong bảng điều khiển Firebase, hãy chuyển đến trang Firebase AI Logic. Nhấp vào Bắt đầu, rồi chọn Gemini Developer API. Bật API 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.

• Nếu bạn vừa trải qua 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.

  Cách xử lý:
  Chờ vài phút, sau đó thử lại yêu cầu.

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

  Cách xử lý:
  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 đó. Vui lòng đảm bảo bạn đang sử dụng một phiên bản mô hình hợp lệ.)

Có một vài lý do khiến bạn có thể gặp phải 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 mà 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. 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 xem trước Gemini 3.1 Pro là gemini-3.1-pro-preview.
    • Tên mô hình xem trước Gemini 3 Flash là gemini-3-flash-preview.
    • Tên mô hình xem trước "Nano Banana Pro" là gemini-3-pro-image-preview.
    • Tên mô hình xem trước "Nano Banana 2" là gemini-3.1-flash-image-preview.
    • Tên mô hình "Nano Banana" là 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 và mô hình xem trước hoặc thử nghiệm)

  • Nguyên nhân: Bạn đang sử dụng phiên bản xem trước hoặc thử nghiệm của một mô hình (ví dụ: gemini-3.1-pro-preview và gemini-3.1-flash-image-preview) và bạn không chỉ định vị trí global.

    Nếu bạn sử dụng Vertex AI Gemini API, thì tất cả các mô hình xem trước và thử nghiệm Gemini (ngoại trừ các mô hình Gemini Live) chỉ có ở vị trí global. Tuy nhiên, vì Firebase AI Logic mặc định là vị trí us-central1, nên bạn cần chỉ định rõ ràng vị trí global khi khởi chạy dịch vụ phụ trợ Vertex AI Gemini API trong mã của mình khi sử dụng các mô hình xem trước và thử nghiệm Gemini này.

  • Cách khắc phục: Khi bạn khởi chạy dịch vụ Vertex AI Gemini API, hãy chỉ định vị trí global. 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ã).

• 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: Bạn đang sử dụng một mô hình không được hỗ trợ ở vị trí mà bạn đang cố gắng truy cập.

    Nếu bạn sử dụng Vertex AI Gemini API, thì một số mô hình chỉ có ở một số vị trí cụ thể. Ví dụ (nhưng không đầy đủ):

    • Các mô hình Imagen không được hỗ trợ ở global vị trí.
    • Gemini Live API mô hình (như gemini-2.0-flash-live-preview-04-09) chỉ được hỗ trợ ở vị trí us-central1.
    • Các mô hình Gemini 2.5 (như gemini-2.5-pro) chỉ có ở vị trí global, các vị trí ở Hoa Kỳ và một số vị trí ở Châu Âu (và đôi khi ở các vị trí khác nếu dự án của bạn có các lựa chọn đặc biệt).

  • Cách khắc phục: Khi bạn khởi chạy dịch vụ Vertex AI Gemini API, hãy đảm bảo rằng bạn chỉ định một vị trí được hỗ trợ cho mô hình mà bạn đang sử dụng. 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ã) và các vị trí được hỗ trợ cho mô hình.

    Xin lưu ý rằng Firebase AI Logic mặc định là vị trí us-central1.

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 rằng bạn đang vượt quá hạn mức hoặc mô hình mà bạn đang truy cập đang bị quá tải do các yêu cầu từ người khác.

Hành động cần thực hiện 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 Giới hạn tốc độ và hạn mức.

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