Trang này cung cấp câu trả lời cho các câu hỏi thường gặp (FAQ) và thông tin khắc phục sự cố về SDK Gemini API và Firebase AI Logic. Để biết thêm câu hỏi, hãy xem phần Câu hỏi thường gặp về Gemini API trong tài liệu về Google Cloud.
Câu hỏi thường gặp chung
Tại sao tên thay đổi từ "Vertex AI trong Firebase" thành "Firebase AI Logic"?
Vào năm 2024, chúng tôi đã ra mắt một bộ SDK ứng dụng Firebase có thể sử dụng Vertex AI Gemini API cũng như một cổng proxy Firebase để bảo vệ API đó khỏi hành vi sử dụng sai trái và cho phép tích hợp với các sản phẩm Firebase khác. Chúng tôi đặt tên sản phẩm là "Vertex AI trong Firebase" và tên sản phẩm này mô tả chính xác các trường hợp sử dụng hiện có của sản phẩm tại thời điểm đó.
Tuy nhiên, kể từ đó, chúng tôi đã mở rộng chức năng của sản phẩm. Ví dụ: kể từ tháng 5 năm 2025, chúng tôi hiện hỗ trợ Gemini Developer API, bao gồm cả khả năng bảo vệ Gemini Developer API khỏi hành vi sử dụng sai mục đích bằng cách tích hợp với Firebase App Check.
Do đó, tên "Vertex AI trong Firebase" không còn phản ánh chính xác phạm vi mở rộng của sản phẩm. Do đó, tên mới — Firebase AI Logic — phản ánh rõ hơn bộ tính năng đang phát triển của chúng tôi và cho phép chúng tôi tiếp tục mở rộng các sản phẩm trong tương lai!
Hãy xem hướng dẫn di chuyển để đảm bảo bạn có tất cả các tính năng mới nhất từ Firebase AI Logic (và có thể bắt đầu sử dụng Gemini Developer API).
Sự khác biệt giữa việc sử dụng Gemini Developer API và Vertex AI Gemini API là gì?
Dưới đây là một số điểm khác biệt giữa hai trình cung cấp "Gemini API" nói chung bất kể bạn truy cập vào trình cung cấp nào:
-
Gemini Developer API cung cấp "cấp miễn phí" cùng với mức giá trả theo mức sử dụng.
Vertex AI Gemini API khi được sử dụng với Firebase AI Logic luôn yêu cầu gói giá linh hoạt (trả tiền theo mức dùng) Blaze.
Xin lưu ý rằng hai nhà cung cấp API có mức giá trả theo mức sử dụng khác nhau (tìm hiểu thêm trong tài liệu tương ứng của họ).
-
Gemini Developer API có giới hạn tốc độ rõ ràng.
Vertex AI Gemini API sử dụng "hạn mức dùng chung động (DSQ)" mà mọi người sử dụng mô hình đó ở khu vực đó đều dùng chung. Bạn cũng có thể tuỳ ý thiết lập thông lượng được cấp phép (PT).
Chỉ định vị trí để truy cập vào mô hình
- Chỉ Vertex AI Gemini API mới cho phép bạn chọn vị trí truy cập vào mô hình.
Bảng sau đây liệt kê các tính năng thường được hỏi về hai trình cung cấp "Gemini API". Bảng này áp dụng cụ thể khi sử dụng SDK ứng dụng Firebase AI Logic.
Tính năng | Gemini Developer API | Vertex AI Gemini API |
---|---|---|
Hỗ trợ cho các mô hình Gemini | tất cả các mô hình Gemini đều được hỗ trợ | tất cả các mô hình Gemini đều được hỗ trợ |
Hỗ trợ cho các mô hình Imagen |
Các mẫu Imagen 3 được hỗ trợ
(chưa có cho Unity) |
Các mẫu Imagen 3 được hỗ trợ
(chưa có cho Unity) |
Hỗ trợ cho các mẫu Veo | chưa được hỗ trợ | chưa được hỗ trợ |
Tạo hình ảnh bằng mô hình Gemini | được hỗ trợ | được hỗ trợ |
Hỗ trợ Gemini Live API | chưa được hỗ trợ |
được hỗ trợ
(chỉ dành cho Android, Flutter và Unity) |
Tích hợp với Firebase App Check | được hỗ trợ | được hỗ trợ |
Tương thích với Firebase Remote Config | được hỗ trợ | được hỗ trợ |
Hỗ trợ tính năng giám sát AI trong bảng điều khiển Firebase | chưa được hỗ trợ | được hỗ trợ |
Hỗ trợ URL Cloud Storage | chưa được hỗ trợ 1 |
Tệp công khai và tệp được bảo vệ bằng Firebase Security Rules |
Hỗ trợ URL YouTube và URL trình duyệt | Chỉ URL của YouTube | URL YouTube và URL trình duyệt |
1 Files API cho Gemini Developer API không được hỗ trợ thông qua SDK Firebase AI Logic.
Tôi có thể sử dụng cả Gemini Developer API và Vertex AI Gemini API không?
Có, bạn có thể bật cả hai trình cung cấp "Gemini API" trong dự án Firebase và bạn có thể sử dụng cả hai API trong chính ứng dụng của mình.
Để chuyển đổi giữa các nhà cung cấp API trong mã, bạn chỉ cần đảm bảo rằng bạn đã đặt dịch vụ phụ trợ một cách thích hợp trong mã.
API bắt buộc là gì? Làm cách nào để bật các tính năng này?
Chọn nhà cung cấp Gemini API để xem nội dung dành riêng cho nhà cung cấp |
Để sử dụng SDK Firebase AI Logic với Gemini Developer API, dự án của bạn phải bật hai API sau:
- Gemini Developer API (
generativelanguage.googleapis.com
) - Firebase AI Logic API (
firebasevertexai.googleapis.com
)
Bạn nên bật hai API này bằng bảng điều khiển Firebase:
Trong bảng điều khiển Firebase, hãy chuyển đến trang Firebase AI Logic.
Nhấp vào Bắt đầu.
Chọn để bắt đầu với Gemini Developer API.
Thao tác này sẽ khởi chạy một quy trình làm việc có hướng dẫn để bật hai API cho bạn. Bảng điều khiển cũng sẽ tạo một khoá API Gemini, cũng như thêm API Firebase AI Logic vào danh sách cho phép cho khoá API Firebase.
Bạn có thể sử dụng những mô hình nào với SDK Firebase AI Logic?
Bạn có thể sử dụng bất kỳ mô hình nền tảng Gemini và Imagen 3 nào với SDK Firebase AI Logic, bao gồm cả các phiên bản xem trước và thử nghiệm. Xem danh sách các mẫu này trong bài viết Tìm hiểu về các mẫu được hỗ trợ.
Bạn không thể sử dụng các mô hình Gemini không phải nền tảng (như mô hình PaLM, mô hình được điều chỉnh hoặc mô hình dựa trên Gemma) với SDK Firebase AI Logic.
Firebase AI Logic cũng không hỗ trợ các mô hình Imagen cũ hoặc
imagen-3.0-capability-001
.Gemini Developer API (bất kể cách truy cập) không hỗ trợ
imagen-3.0-fast-generate-001
hoặcimagen-3.0-generate-001
cũ.
Chúng tôi thường xuyên thêm các tính năng mới vào SDK. Vì vậy, hãy quay lại phần Câu hỏi thường gặp này để xem nội dung cập nhật (cũng như trong ghi chú phát hành, blog và bài đăng trên mạng xã hội).
Việc cần làm khi mô hình ngừng hoạt động?
Khi phát hành phiên bản mô hình ổn định, chúng tôi cố gắng đảm bảo rằng phiên bản đó sẽ có sẵn trong ít nhất một năm. Chúng tôi liệt kê "ngày ngừng hoạt động" này ở một số nơi trong tài liệu về Firebase và Google Cloud (ví dụ: trong trang"Mô hình").
Khi một mô hình ngừng hoạt động, mọi yêu cầu gửi đến mô hình đó sẽ không thực hiện được và trả về lỗi 404. Vì lý do này, bạn nên thiết lập và sử dụng Firebase Remote Config để có thể thay đổi linh động mô hình và phiên bản trong ứng dụng mà không cần phát hành phiên bản mới của ứng dụng.
Khi cập nhật ứng dụng để sử dụng phiên bản mô hình mới, bạn nên kiểm thử ứng dụng để đảm bảo rằng các phản hồi vẫn như mong đợi. Xin lưu ý rằng khi sử dụng Firebase AI Logic, thường không cần sửa đổi bất kỳ mã nào thực sự gọi đến mô hình.
Sau đây là ngày ngừng hỗ trợ cho nhiều mô hình:
Mô hình Gemini 1.5 Pro:
gemini-1.5-pro-002
(vàgemini-1.5-pro
): Ngày 24 tháng 9 năm 2025gemini-1.5-pro-001
: Ngày 24 tháng 5 năm 2025
Mô hình Gemini 1.5 Flash:
gemini-1.5-flash-002
(vàgemini-1.5-flash
): Ngày 24 tháng 9 năm 2025gemini-1.5-flash-001
: Ngày 24 tháng 5 năm 2025
Các mẫu Gemini 1.0 Pro Vision: Ngày 21 tháng 4 năm 2025 (trước đây dự kiến là ngày 9 tháng 4 năm 2025)
Các mẫu Gemini 1.0 Pro: Ngày 21 tháng 4 năm 2025 (trước đây dự kiến là ngày 9 tháng 4 năm 2025)
Làm cách nào để đặt giới hạn tốc độ trên mỗi người dùng?
Theo mặc định, Firebase AI Logic đặt hạn mức yêu cầu cho mỗi người dùng là 100 yêu cầu mỗi phút (RPM).
Nếu muốn điều chỉnh hạn mức tốc độ trên mỗi người dùng, bạn cần điều chỉnh chế độ cài đặt hạn mức cho API Firebase AI Logic.
Tìm hiểu thêm về hạn mức API Firebase AI Logic. Trên trang đó, bạn cũng có thể tìm hiểu cách xem và chỉnh sửa hạn mức.
Cần có những quyền nào để sử dụng SDK Firebase AI Logic?
Thao tác | Các quyền IAM bắt buộc | (Các) vai trò IAM có các quyền bắt buộc theo mặc định |
---|---|---|
Nâng cấp gói thanh toán lên gói giá trả tiền theo mức dùng (Blaze) | firebase.billingPlans.update resourcemanager.projects.createBillingAssignment resourcemanager.projects.deleteBillingAssignment
|
Chủ sở hữu |
Bật API trong dự án | serviceusage.services.enable |
Người chỉnh sửa Chủ sở hữu |
Tạo ứng dụng Firebase | firebase.clients.create |
Quản trị viên Firebase Người chỉnh sửa Chủ sở hữu |
Firebase AI Logic có sử dụng dữ liệu của tôi để huấn luyện mô hình không?
Xem phần Quản trị dữ liệu và AI có trách nhiệm.
Loại MIME có bắt buộc trong các yêu cầu đa phương thức của tôi không? (chẳng hạn như đối với hình ảnh, tệp PDF, video và dữ liệu đầu vào âm thanh)
Có, trong mỗi yêu cầu đa phương thức, bạn phải luôn cung cấp những thông tin sau:
mimeType
của tệp. Xem ngoại lệ bên dưới.Tệp. Bạn có thể cung cấp tệp dưới dạng dữ liệu cùng dòng hoặc cung cấp tệp bằng URL của tệp.
Tìm hiểu về các loại tệp đầu vào được hỗ trợ, cách chỉ định loại MIME và hai tuỳ chọn để cung cấp tệp trong phần Các yêu cầu và tệp đầu vào được hỗ trợ.
Trường hợp ngoại lệ khi thêm loại MIME vào yêu cầu
Một ngoại lệ đối với việc cung cấp loại MIME là dữ liệu đầu vào hình ảnh cùng dòng cho các yêu cầu từ các ứng dụng gốc trên nền tảng Android và Apple.
SDK Firebase AI Logic cho nền tảng Android và Apple cung cấp một cách đơn giản và thân thiện với nền tảng để xử lý hình ảnh trong các yêu cầu — tất cả hình ảnh (bất kể định dạng) đều được chuyển đổi sang JPEG ở phía máy khách với chất lượng 80% trước khi được gửi đến máy chủ. Điều này có nghĩa là khi cung cấp hình ảnh dưới dạng dữ liệu nội tuyến bằng SDK nền tảng Android và Apple, bạn không cần chỉ định loại MIME trong yêu cầu.
Cách xử lý đơn giản này được trình bày trong tài liệu Firebase AI Logic trong các ví dụ về cách gửi hình ảnh được mã hoá base64 trong các yêu cầu.
Sau đây là một số thông tin bổ sung theo nền tảng về tính năng này:
Đối với Android:
Bạn có thể tận dụng cách đơn giản để xử lý các loại hình ảnh gốc của nền tảng (
Bitmap
) trong các lời nhắc đa phương thức chứa hình ảnh dưới dạng dữ liệu nội tuyến (xem ví dụ).Để kiểm soát nhiều hơn các định dạng hình ảnh và lượt chuyển đổi, bạn có thể cung cấp hình ảnh dưới dạng
InlineDataPart
và cung cấp loại MIME cụ thể. Ví dụ:content { inlineData(/* PNG as byte array */, "image/png") }
Đối với nền tảng Apple:
Bạn có thể tận dụng cách đơn giản để xử lý các loại hình ảnh gốc của nền tảng (
UIImage
,NSImage
,CIImage
vàCGImage
) trong lời nhắc đa phương thức chứa hình ảnh dưới dạng dữ liệu nội tuyến (xem ví dụ).Để kiểm soát nhiều hơn các định dạng hình ảnh và lượt chuyển đổi, bạn có thể cung cấp hình ảnh dưới dạng
InlineDataPart
và cung cấp loại MIME cụ thể. Ví dụ:InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")
Các tính năng này có dùng được khi sử dụng Firebase AI Logic không? Lưu vào bộ nhớ đệm ngữ cảnh, Tìm kiếm dưới dạng một công cụ, liên kết với Google Tìm kiếm, thực thi mã, tinh chỉnh mô hình, tạo nội dung nhúng và truy xuất ngữ nghĩa?
Nhiều mô hình hoặc Vertex AI Gemini API hỗ trợ tính năng lưu ngữ cảnh vào bộ nhớ đệm, Tìm kiếm dưới dạng công cụ, liên kết với Google Tìm kiếm, thực thi mã, điều chỉnh mô hình, tạo nội dung nhúng và truy xuất ngữ nghĩa, nhưng các tính năng này sẽ không hoạt động khi bạn sử dụng Firebase AI Logic.
Nếu bạn muốn thêm các tính năng này dưới dạng yêu cầu tính năng hoặc bỏ phiếu cho một yêu cầu tính năng hiện có, hãy truy cập vào Firebase UserVoice.
Câu hỏi thường gặp về khoá API Gemini
Những câu hỏi thường gặp này chỉ áp dụng nếu bạn đang sử dụng Gemini Developer API.
Khoá API Gemini là gì?
Gemini Developer API sử dụng "khoá API Gemini" để uỷ quyền cho phương thức gọi. Vì vậy, nếu đang sử dụng Gemini Developer API thông qua SDK Firebase AI Logic, thì bạn cần có khoá API Gemini hợp lệ trong dự án Firebase để thực hiện lệnh gọi đến API đó.
"Khoá API Gemini" chỉ có nghĩa là khoá API có Gemini Developer API trong danh sách cho phép sử dụng API.
Khi bạn thực hiện quy trình thiết lập Firebase AI Logic trong bảng điều khiển Firebase, chúng tôi sẽ tạo một khoá API Gemini chỉ dành cho Gemini Developer API và thiết lập dịch vụ proxy Firebase AI Logic để sử dụng khoá API này. Khoá API Gemini do Firebase tạo này có tên là Khoá API dành cho nhà phát triển Gemini (do Firebase tự động tạo) trong trang thông tin xác thực của bảng điều khiển Google Cloud.
Tìm hiểu thêm về các quy định hạn chế về API đối với khoá API.
Bạn không thêm khoá API Gemini vào cơ sở mã của ứng dụng khi sử dụng SDK Firebase AI Logic. Tìm hiểu thêm về cách bảo mật khoá API Gemini.
Tôi có nên thêm khoá API Gemini vào cơ sở mã của ứng dụng dành cho thiết bị di động hoặc web không?
Khi sử dụng SDK Firebase AI Logic, đừng thêm khoá API Gemini vào cơ sở mã của ứng dụng.
Trên thực tế, trong khi phát triển bằng SDK Firebase AI Logic, bạn không tương tác trực tiếp với khoá API Gemini. Thay vào đó, dịch vụ proxy Firebase AI Logic của chúng ta sẽ đưa khoá API Gemini vào trong mỗi yêu cầu đến Gemini Developer API — hoàn toàn ở phần phụ trợ.
Làm cách nào để thay đổi khoá API Gemini dùng để gọi Gemini Developer API?
Khi sử dụng SDK Firebase AI Logic, bạn có thể sẽ không cần thay đổi khoá API Gemini. Tuy nhiên, có hai trường hợp bạn có thể cần:
Nếu bạn vô tình làm rò rỉ khoá và muốn thay thế khoá đó bằng một khoá mới bảo mật.
Nếu bạn vô tình xoá khoá. Xin lưu ý rằng bạn có thể huỷ xoá khoá trong vòng 30 ngày kể từ khi xoá.
Sau đây là cách thay đổi khoá API Gemini mà SDK Firebase AI Logic sử dụng:
Nếu khoá API Gemini do Firebase tạo vẫn tồn tại, hãy xoá khoá đó.
Bạn có thể xoá khoá API này trong bảng điều khiển API và Dịch vụ > Thông tin xác thực của bảng điều khiển Google Cloud. Khoá này có tên là:
Khoá API dành cho nhà phát triển Gemini (do Firebase tự động tạo).Trên cùng một trang của bảng điều khiển Google Cloud, hãy tạo một khoá API mới. Bạn nên đặt tên như sau:
Khoá API dành cho nhà phát triển Gemini cho Firebase.Đối với khoá API mới này, hãy thêm các quy tắc hạn chế đối với API và chỉ chọn API Ngôn ngữ tạo sinh.
"Generative Language API" (API Ngôn ngữ tạo sinh) là tên gọi đôi khi của Gemini Developer API trong bảng điều khiển Google Cloud.Đừng thêm bất kỳ hạn chế nào đối với ứng dụng; nếu không, dịch vụ proxy Firebase AI Logic sẽ không hoạt động như mong đợi.
Chạy lệnh sau để đặt khoá mới này làm khoá API Gemini mà dịch vụ proxy Firebase AI Logic sẽ sử dụng.
PROJECT_ID="PROJECT_ID" GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY" curl \ -X PATCH \ -H "x-goog-user-project: ${PROJECT_ID}" \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \ -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
Tìm hiểu về gcloud CLI.
Hãy nhớ không thêm khoá API Gemini mới này vào cơ sở mã của ứng dụng. Tìm hiểu thêm về cách bảo mật khoá API Gemini.
Tôi có thể sử dụng "Khoá API Firebase" làm khoá API Gemini không?
Không — bạn không nên sử dụng "khoá API Firebase" làm khoá API Gemini. Bạn không nên thêm Gemini Developer API vào danh sách cho phép cho khoá API Firebase.
Khoá API Firebase là khoá API được liệt kê trong tệp cấu hình Firebase hoặc đối tượng mà bạn thêm vào cơ sở mã của ứng dụng để kết nối ứng dụng với Firebase. Bạn có thể đưa khoá API Firebase vào mã khi chỉ sử dụng khoá đó với các API liên quan đến Firebase (chẳng hạn như Firebase AI Logic). Tìm hiểu thông tin quan trọng về khoá API Firebase.
Trong bảng điều khiển API và Dịch vụ > Thông tin xác thực của bảng điều khiển Google Cloud, khoá API Firebase có dạng như sau:
Vì bạn cần thêm khoá API Firebase vào cơ sở mã của ứng dụng để các API liên quan đến Firebase hoạt động, và vì Gemini Developer API được uỷ quyền thông qua khoá API, bạn KHÔNG nên thêm Gemini Developer API (được gọi là "API ngôn ngữ tạo sinh" trong bảng điều khiển Google Cloud) vào danh sách cho phép API cho khoá API Firebase. Nếu làm vậy, bạn sẽ khiến Gemini Developer API có nguy cơ bị lợi dụng.
Làm cách nào để bảo mật khoá API Gemini?
Câu hỏi thường gặp này mô tả một số phương pháp hay nhất được đề xuất để bảo mật khoá API Gemini.
Nếu bạn đang gọi Gemini Developer API trực tiếp từ ứng dụng web hoặc ứng dụng di động:
- Sử dụng SDK ứng dụng Firebase AI Logic.
- Đừng thêm khoá API Gemini vào cơ sở mã của ứng dụng.
Firebase AI Logic cung cấp dịch vụ proxy bao gồm khoá API Gemini trong nội bộ trong mỗi yêu cầu đến Gemini Developer API — hoàn toàn ở phần phụ trợ.
Ngoài ra, bạn nên làm những việc sau:
Ngay khi bạn bắt đầu phát triển ứng dụng một cách nghiêm túc, hãy tích hợp với Firebase App Check để giúp bảo vệ tài nguyên phụ trợ cũng như các API dùng để truy cập vào mô hình tạo sinh.
Đừng sử dụng lại khoá API Gemini do Firebase tạo bên ngoài Firebase AI Logic. Nếu bạn cần một khoá API Gemini cho một trường hợp sử dụng khác, hãy tạo một khoá riêng.
Nhìn chung, bạn KHÔNG nên sửa đổi khoá API Gemini do Firebase tạo. Khoá này có tên là Gemini Developer API key (auto created by Firebase) (Khoá API dành cho nhà phát triển Gemini (do Firebase tự động tạo)) trong bảng điều khiển Google Cloud.
Đừng thêm bất kỳ API nào khác vào danh sách cho phép API cho khoá API Gemini do Firebase tạo. Trong danh sách cho phép sử dụng API, khoá API Gemini của bạn chỉ có Gemini Developer API (được gọi là "API ngôn ngữ tạo sinh" trong bảng điều khiển Google Cloud).
Đừng thêm bất kỳ hạn chế nào đối với ứng dụng; nếu không, dịch vụ proxy Firebase AI Logic sẽ không hoạt động như mong đợi.
Khoá API Gemini của tôi đã bị xâm phạm. Việc bạn cần làm
Nếu khoá API Gemini của bạn đã bị xâm phạm, hãy làm theo hướng dẫn để thay đổi khoá API Gemini dùng để gọi Gemini Developer API.
Ngoài ra, hãy tham khảo các phương pháp hay nhất được đề xuất để bảo mật khoá API Gemini.
Khắc phục lỗi
Làm cách nào để khắc phục lỗi 404 này? 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á API Gemini hợp lệ để sử dụng với SDK ứng dụng Firebase AI Logic.
Dưới đâ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 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, hãy thử lại yêu cầu của bạn.Nếu gần đây bạn đã thực hiện quy trình thiết lập Firebase AI Logic trong bảng điều khiển Firebase, thì khoá API Gemini của bạn 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:
Chờ vài phút rồi thử lại yêu cầu của bạn.Khoá API Gemini của bạn có thể đã bị xoá khỏi dự án Firebase.
Việc cần làm:
Tìm hiểu cách thay đổi khoá API Gemini mà Firebase AI Logic sử dụng.
Làm cách nào để khắc phục lỗi 400 này? 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 URL Cloud Storage for Firebase, 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 dự án không có các tác nhân dịch vụ bắt buộc được tự động cấp phép đúng cách khi bật API Vertex AI trong dự án. Đây là vấn đề đã biết 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.
Dưới đây là giải pháp khắc phục dự án và cấp phát chính xác 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 của dự án và chỉ cần hoàn thành một lần bộ nhiệm vụ này cho dự án của mình.
Truy cập và xác thực bằng gcloud CLI.
Cách dễ nhất để làm việc này là từ Cloud Shell. Tìm hiểu thêm trong tài liệu về Google Cloud.Nếu được nhắc, hãy làm theo hướng dẫn xuất hiện trong dòng lệnh để 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 settings Cài đặt dự án trong bảng điều khiển Firebase.
Cung cấp các tác nhân dịch vụ bắt buộc trong dự án của bạ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 ''
Chờ vài phút để đảm bảo rằng các tác nhân dịch vụ đã được cấp phép, sau đó thử gửi lạ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 đợi vài phút, hãy liên hệ với Nhóm hỗ trợ Firebase.
Làm cách nào để khắc phục lỗi 400 này? 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ì đ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.
Kiểm tra để đảm bảo 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 bảng điều khiển Google Cloud.
Nếu bạn phát hiện thấy các khoá không khớp, hãy tải một tệp/đối tượng cấu hình Firebase mới, sau đó thay thế tệp/đối tượng cấu hình hiện có trong ứng dụng. 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àm cách nào để khắc phục lỗi 403 này? 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ì đ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 có API bắt buộc trong danh sách cho phép cho sản phẩm mà bạn đang cố gắng sử dụng.
Đảm bảo rằng khoá API mà ứng dụng của bạn sử dụng có tất cả API bắt buộc có trong danh sách cho phép "Hạn chế API" của khoá. Đối với Firebase AI Logic, khoá API của bạn cần có ít nhất API Firebase AI Logic trong danh sách cho phép.
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 bảng điều khiển Google Cloud.
Làm cách nào để khắc phục lỗi 403 này? 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 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 bảng điều khiển Google Cloud.
Nếu bạn phát hiện thấy các khoá không khớp, hãy tải một tệp/đối tượng cấu hình Firebase mới, sau đó thay thế tệp/đối tượng cấu hình hiện có trong ứng dụng. 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.
Gửi ý kiến phản hồi về trải nghiệm của bạn với Firebase AI Logic