Gemini API'yi Firebase için Vertex AI SDK'larını kullanarak kullanmaya başlayın


Bu kılavuzda, Firebase için Vertex AI SDK'larını kullanarak doğrudan uygulamanızdan Vertex AI Gemini API'ye nasıl çağrı yapmaya başlayacağınız gösterilmektedir.

Ön koşullar

Bu kılavuzda, web uygulamaları geliştirmek için JavaScript kullanma konusunda bilgi sahibi olduğunuz varsayılır. Bu kılavuz çerçeveden bağımsızdır.

  • 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 eksiksiz bir şekilde kullanıldığını görebilir veya kendi web uygulamanız yoksa örnek uygulamayı kullanabilirsiniz. Örnek uygulamayı kullanmak için uygulamayı bir Firebase projesine bağlamanız gerekir.

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

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

  1. Firebase konsolunda Build with Gemini sayfasına gidip ikinci kartı tıklayarak aşağıdaki görevleri gerçekleştirmenize yardımcı olacak bir iş akışı başlatın. Vertex AI'da konsolda bir sekme görüyorsanız bu işlemler tamamlanmış demektir.

  2. SDK'yı uygulamanıza eklemek için bu kılavuzdaki bir sonraki adıma geçin.

Halihazırda bir Firebase projeniz ve Firebase'e bağlı bir uygulamanız yoksa


2. Adım: SDK'yı ekleyin

Firebase projenizi oluşturduktan ve uygulamanız Firebase'e bağlıyken (önceki adıma bakın) Firebase için Vertex AI SDK'sını uygulamanıza ekleyebilirsiniz.

Firebase için Vertex AI kitaplığı, Vertex AI Gemini API'ye erişim sağlar ve web için Firebase JavaScript SDK'sına dahildir.

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

    npm install firebase

  2. Uygulamanızda Firebase'i 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ısı yapabilmek için Vertex AI hizmetini ve üretken modeli ilk kullanıma hazırlamanız gerekir.

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

// 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
// Gemini 1.5 models are versatile and can be used with all API capabilities
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash-preview-0514" });

Başlangıç kılavuzunu tamamladığınızda Gemini modelini ve (isteğe bağlı olarak) kullanım alanınıza ve uygulamanıza uygun konumu nasıl seçeceğinizi öğrenin.

4. adım: Vertex AI Gemini API'yi çağırın

Uygulamanızı Firebase'e bağlayıp SDK'yı eklediğinize, Vertex AI hizmetini ve üretken modeli başlattığınıza göre artık Vertex AI Gemini API'yi çağırmaya hazırsınız.

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

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

// 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
// Gemini 1.5 models are versatile and can be used with all API capabilities
const model = getGenerativeModel(vertexAI, { model: "gemini-1.5-flash-preview-0514" });

// 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 ne yapabilirsiniz?

Gemini modelleri hakkında daha fazla bilgi

Çeşitli kullanım alanları için kullanılabilecek modeller ve bunların kotaları ve fiyatlandırması hakkında bilgi edinin.

Gemini API'nin diğer özelliklerini deneyin

İçerik üretme işlemini nasıl kontrol edeceğinizi öğrenin

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


Firebase için Vertex AI deneyiminizle ilgili geri bildirimde bulunun