Firebase SDK'larında Vertex


Bu kılavuzda, seçtiğiniz platforma ait Vertex AI in Firebase SDK'sını kullanarak doğrudan uygulamanızdan Vertex AI Gemini API çağrıları nasıl yapacağınız gösterilmektedir.

Vertex AI in Firebase SDK'larını kullanarak Imagen modellerine erişmeye başlamak için bu kılavuzu da kullanabileceğinizi unutmayın.

Ön koşullar

Bu kılavuzda, web uygulamaları geliştirmek için JavaScript'i kullanma konusunda bilgi sahibi olduğunuz varsayılmaktadır. Bu kılavuz, çerçeveye bağlı değildir.

  • Geliştirme ortamınızın ve web uygulamanızın aşağıdaki koşulları karşıladığından emin olun:

    • (İsteğe bağlı) Node.js
    • Modern web tarayıcısı

  • (İsteğe bağlı) Örnek uygulamaya göz atın.

    Örnek uygulamayı indirin

    SDK'yı hızlıca deneyebilir, çeşitli kullanım alanlarının tam uygulamasını görebilir veya kendi web uygulamanız yoksa örnek uygulamayı kullanabilirsiniz. Örnek uygulamayı kullanmak için bir Firebase projesine bağlamanız gerekir.

1. adım: Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın

Zaten bir Firebase projeniz ve Firebase'e bağlı bir uygulamanız varsa

  1. Firebase konsolunda Gemini ile oluşturma sayfasına gidin.

  2. Aşağıdaki görevleri tamamlamanıza yardımcı olacak bir iş akışı başlatmak için Vertex AI in Firebase kartını tıklayın:

  3. SDK'yı uygulamanıza eklemek için bu kılavuzun bir sonraki adımına geçin.

Firebase projesiniz ve Firebase'e bağlı uygulamanız yoksa

  1. Firebase konsolunda oturum açın.

  2. Proje oluştur'u tıklayın ve ardından aşağıdaki seçeneklerden birini kullanın:

    • 1. seçenek: "Proje oluştur" iş akışının ilk adımına yeni bir proje adı girerek tamamen yeni bir Firebase projesi (ve otomatik olarak temel Google Cloud projesi) oluşturun.

    • 2. Seçenek: "Proje oluştur" iş akışının ilk adımındaki açılır menüden Google Cloud proje adınızı seçerek mevcut bir Google Cloud projesine "Firebase ekleyin".

    İstendiğinde, Vertex AI in Firebase SDK'larını kullanmak için Google Analytics'i ayarlamanıza gerek olmadığını unutmayın.

  3. Firebase konsolunda Gemini ile oluşturma sayfasına gidin.

  4. Aşağıdaki görevleri tamamlamanıza yardımcı olacak bir iş akışı başlatmak için Vertex AI in Firebase kartını tıklayın:

  1. Uygulamanızı Firebase'e bağlamak için konsolun üretken yapay zeka iş akışında devam edin. Bu iş akışı aşağıdaki görevleri içerir:

    • Uygulamanızı Firebase projenize kaydettirme

    • Firebase yapılandırma nesnenizi uygulamanıza ekleme.

  2. Bu kılavuzun sonraki adımlarında, Vertex AI in Firebase SDK'sını uygulamanıza ekleyecek ve SDK ile Gemini API'un kullanımına özel gerekli başlatma işlemlerini tamamlayacaksınız.


2. adım: SDK'yı ekleyin

Firebase projeniz oluşturulduktan ve uygulamanız Firebase'e bağlandıktan sonra (önceki adıma bakın) Vertex AI in Firebase SDK'sını uygulamanıza ekleyebilirsiniz.

Vertex AI in Firebase kitaplığı, Gemini ve Imagen modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Web için Firebase JavaScript SDK'sının bir parçası olarak dahil edilmiştir.

  1. npm kullanarak Web için Firebase JS SDK'sını yükleyin:

      npm install firebase

  2. Firebase'i uygulamanızda başlatın:

      import { initializeApp } from "firebase/app";

  // TODO(developer) Replace the following with your app's Firebase configuration
  // See: https://firebase.google.com/docs/web/learn-more#config-object
  const firebaseConfig = {
    // ...
  };

  // Initialize FirebaseApp
  const firebaseApp = initializeApp(firebaseConfig);

3. Adım: Vertex AI hizmetini ve üretken modeli başlatın

API çağrıları yapıp Gemini modeli isteğinde bulunabilmek için Vertex AI hizmetini ve üretken modeli başlatmanız gerekir.

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// Initialize the generative model with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });

Bu başlangıç kılavuzunu tamamladıktan sonra, kullanım alanınıza ve uygulamanıza uygun bir model ve (isteğe bağlı olarak) konum seçmeyi öğrenin.

4. Adım: Bir modele istem isteği gönderin

Uygulamanızı Firebase'e bağladığınıza, SDK'yı eklediğinize, Vertex AI hizmetini ve üretken modeli başlattığınıza göre Gemini modeline istem isteği göndermeye hazırsınız.

Yalnızca metin içeren bir istem isteğinden metin oluşturmak için generateContent() kullanabilirsiniz:

import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI service
const vertexAI = getVertexAI(firebaseApp);

// Initialize the generative model with a model that supports your use case
const model = getGenerativeModel(vertexAI, { model: "gemini-2.0-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

Başka neler yapabilirsiniz?

Desteklenen modeller hakkında daha fazla bilgi

Çeşitli kullanım alanları için kullanılabilen modeller, kotaları ve fiyatlandırmaları hakkında bilgi edinin.

Gemini API'ün diğer özelliklerini deneyin

İçerik oluşturmayı nasıl kontrol edeceğinizi öğrenin

Vertex AI Studio'i kullanarak istemler ve model yapılandırmalarıyla da denemeler yapabilirsiniz.


Vertex AI in Firebase ile ilgili deneyiminiz hakkında geri bildirim verme