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, Apple platformları (ör. iOS) için uygulama geliştirmek üzere Xcode'un nasıl kullanıldığı konusunda bilgi sahibi olduğunuz varsayılır.

  • Geliştirme ortamınızın ve Apple platformları uygulamanızın aşağıdaki gereksinimleri karşıladığından emin olun:

    • Xcode 15.0 veya üstü
    • Uygulamanız iOS 15 veya sonraki sürümleri ya da macOS 12 veya sonraki sürümleri hedeflemelidir.
  • (İsteğe bağlı) Örnek uygulamaya göz atın.

    Örnek uygulamayı indirin

    SDK'yı hızlı bir şekilde deneyebilir, çeşitli kullanım alanlarının eksiksiz bir uygulamasını görebilir veya kendinize ait Apple platformları uygulamanız yoksa örnek uygulamayı kullanabilirsiniz. Örnek uygulamayı kullanmak için 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 Build with Gemini sayfasına gidin ve ardından aşağıdaki görevleri gerçekleştirmenize yardımcı olacak bir iş akışını başlatmak için ikinci kartı tıklayın. Konsolda Vertex AI'ın yer aldığı bir sekme görürseniz bu görevler tamamlanmış demektir.

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

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


2. adım: SDK'yı ekleyin

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

Vertex AI Gemini API for Firebase kitaplığına erişim sunan Vertex AI Gemini API, Apple platformları için Firebase SDK'sına (firebase-ios-sdk) dahildir. Firebase için Vertex AI kitaplığında Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Package Manager'ı kullanmanız gerekir. CocoaPods gibi diğer paket yöneticileri şu anda desteklenmemektedir.

  1. Xcode'da, uygulama projeniz açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.

  2. İstendiğinde Firebase Apple platform SDK deposunu ekleyin:

      https://github.com/firebase/firebase-ios-sdk
    
  3. En son SDK sürümünü seçin.

  4. FirebaseVertexAI-Preview kitaplığını seçin.

    İşlem tamamlandığında Xcode arka planda bağımlılıklarınızı çözümlemeye ve indirmeye otomatik olarak başlar.

3. adım: Vertex AI hizmetini ve üretken modeli ilk kullanıma hazırlayın

API çağrısı yapabilmeniz için Vertex AI hizmetini ve üretken modeli ilk kullanıma hazırlamanız gerekir.

  1. FirebaseVertexAI modülünü içe aktarma:

    import FirebaseVertexAI
    
  2. Vertex AI hizmetini ve üretken modeli ilk kullanıma hazırlayın:

    import FirebaseVertexAI
    
    // Initialize the Vertex AI service
    let vertex = VertexAI.vertexAI()
    
    // 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
    let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")
    

Başlangıç kılavuzunu tamamladığınızda Gemini modelini nasıl seçeceğinizi ve (isteğe bağlı olarak) kullanım alanınıza ve uygulamanıza uygun bir 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 isteminden metin oluşturmak için generateContent() kullanabilirsiniz:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// 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
let model = vertex.generativeModel(modelName: "gemini-1.5-flash-preview-0514")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Başka ne yapabilirsiniz?

Gemini modelleri hakkında daha fazla bilgi

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

Gemini API'nin diğer özelliklerini deneyin

İçerik oluşturmayı 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