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 rehberde, Flutter ile uygulama geliştirme hakkında bilgi sahibi olduğunuz varsayılmaktadır.

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

    • Dart 3.2.0 ve üzeri

  • (İ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 Flutter 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. Gerekli komut satırı araçlarını yükleyin:

    1. Henüz yapmadıysanız Firebase CLI'yi yükleyin.

    2. Aşağıdaki komutu çalıştırarak Google Hesabınızı kullanarak Firebase'e giriş yapın:

      firebase login

    3. Aşağıdaki komutu herhangi bir dizinden çalıştırarak FlutterFire CLI'yi yükleyin:

      dart pub global activate flutterfire_cli

  2. Uygulamalarınızı Firebase'i kullanacak şekilde yapılandırın:

    Flutter uygulamalarınızı Firebase'e bağlanacak şekilde yapılandırmak için FlutterFire CLI'yi kullanın.

    Uygulama yapılandırma iş akışını başlatmak için Flutter proje dizininizde aşağıdaki komutu çalıştırın:

    flutterfire configure

    flutterfire configure iş akışı aşağıdakileri yapar:

    • Flutter uygulamanızda desteklenen platformları (iOS, Android, Web) seçmenizi ister. FlutterFire CLI, seçilen her platform için Firebase projenizde yeni bir Firebase uygulaması oluşturur.

      Mevcut bir Firebase projesini kullanmayı veya yeni bir Firebase projesi oluşturmayı seçebilirsiniz. Mevcut bir Firebase projesine kayıtlı uygulamalarınız varsa FlutterFire CLI, mevcut Flutter proje yapılandırmanıza göre bunları eşleştirmeye çalışır.

    • Bir Firebase yapılandırma dosyası (firebase_options.dart) oluşturur ve Flutter uygulamanızın lib/ dizinine ekler.

  3. 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.

Flutter için Vertex AI in Firebase eklentisi (firebase_vertexai), Gemini ve Imagen modelleriyle etkileşim kurmak için API'lere erişim sağlar.

  1. Temel eklentiyi ve Vertex AI in Firebase eklentisini yüklemek için Flutter proje dizininizden aşağıdaki komutu çalıştırın:

    flutter pub add firebase_core && flutter pub add firebase_vertexai

  2. lib/main.dart dosyanıza Firebase ana eklentisini, Vertex AI in Firebase eklentisini ve daha önce oluşturduğunuz yapılandırma dosyasını aktarın:

    import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'firebase_options.dart';

  3. Ayrıca lib/main.dart dosyanızda, yapılandırma dosyası tarafından dışa aktarılan DefaultFirebaseOptions nesnesini kullanarak Firebase'i başlatın:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. Flutter uygulamanızı yeniden oluşturun:

    flutter run

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 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(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 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

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