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.
Gemini API ile çalışmayla ilgili diğer seçenekler
İsteğe bağlı olarak, Gemini API
Google AI Studio ve Google AI istemci SDK'larını kullanarak ücretsiz erişim elde etme (sınırlamalar dahilinde ve kullanılabilir olduğunda) özelliğinin alternatif "Google AI" sürümünü deneyin. Bu SDK'lar, mobil ve web uygulamalarında yalnızca prototipleme için kullanılmalıdır.Gemini API'ün işleyiş şeklini öğrendikten sonra, Vertex AI in Firebase SDK'larımıza geçin (bu dokümanlar). Bu SDK'lar, mobil ve web uygulamaları için önemli olan birçok ek özelliğe sahiptir. Örneğin, Firebase App Check kullanarak API'yi kötüye kullanımdan koruma ve isteklerde büyük medya dosyalarını destekleme gibi.
İsteğe bağlı olarak Vertex AI Gemini API sunucu tarafı çağrısı yapın (ör. Python, Node.js veya Go ile)
Gemini API için sunucu tarafı Vertex AI SDK'larını, Firebase Genkit veya Firebase Extensions kullanın.
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, Apple platformları (iOS gibi) için uygulama geliştirmek amacıyla Xcode'u kullanma konusunda bilgi sahibi olduğunuz varsayılmaktadır.
Geliştirme ortamınızın ve Apple platformları uygulamanızın aşağıdaki koşulları karşıladığından emin olun:
- Xcode 15.2 veya sonraki sürümler
- Uygulamanız iOS 15 veya sonraki bir sürümü ya da macOS 12 veya sonraki bir sürümü hedeflemelidir.
(İsteğe bağlı) Örnek uygulamaya göz atın.
SDK'yı hızlıca deneyebilir, çeşitli kullanım alanlarının tam uygulamasını görebilir veya kendi Apple platformu 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
Firebase konsolunda Gemini ile oluşturma sayfasına gidin.
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:
Projenizi kullandığınız kadar öde Blaze fiyatlandırma planını kullanacak şekilde yükseltin.
Projenizde gerekli API'leri (Vertex AI API ve Vertex AI in Firebase API) etkinleştirin.
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
Firebase projesi oluşturma
Firebase konsolunda oturum açın.
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.
Firebase konsolunda Gemini ile oluşturma sayfasına gidin.
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:
Projenizi kullandığınız kadar öde Blaze fiyatlandırma planını kullanacak şekilde yükseltin.
Projenizde gerekli API'leri (Vertex AI API ve Vertex AI in Firebase API) etkinleştirin.
Uygulamanızı Firebase'e bağlama
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 dosyanızı (
) uygulamanıza ekleyin.GoogleService-Info.plist
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.
Firebase bağımlılarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.
Vertex AI in Firebase kitaplığı, Gemini ve Imagen modelleriyle etkileşim kurmak için API'lere erişim sağlar. Kitaplık, Apple platformları için Firebase SDK'sının (firebase-ios-sdk
) bir parçası olarak dahil edilmiştir.
Xcode'da, uygulamanız açıkken Dosya > Paket Ekle'ye gidin.
İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
https://github.com/firebase/firebase-ios-sdk
En son SDK sürümünü seçin.
FirebaseVertexAI
kitaplığını seçin.İşlem tamamlandığında Xcode, arka planda bağımlılarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
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.
FirebaseVertexAI
modülünü içe aktarın:import FirebaseVertexAI
Vertex AI hizmetini ve üretken modeli başlatın:
import FirebaseVertexAI // Initialize the Vertex AI service let vertex = VertexAI.vertexAI() // Initialize the generative model with a model that supports your use case let model = vertex.generativeModel(modelName: "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 FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Initialize the generative model with a model that supports your use case
let model = vertex.generativeModel(modelName: "gemini-2.0-flash")
// 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)
print(response.text ?? "No text in response.")
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
- Yanıtı yayınlama dahil olmak üzere yalnızca metin istemlerinden metin oluşturma hakkında daha fazla bilgi edinin.
- Çoklu formatlı istemlerden (metin, resim, PDF, video ve ses dahil) metin oluşturun.
- Çoklu katılımlı görüşmeler (sohbet) oluşturabilirsiniz.
- Hem metin hem de çoklu modal istemlerden yapılandırılmış çıkış (JSON gibi) oluşturun.
- Üretken modelleri harici sistemlere ve bilgilere bağlamak için işlev çağırma özelliğini kullanın.
İçerik oluşturmayı nasıl kontrol edeceğinizi öğrenin
- En iyi uygulamalar, stratejiler ve örnek istemler dahil olmak üzere istem tasarımını anlama
- Sıcaklık ve maksimum çıkış jetonu (Gemini için) ya da en boy oranı ve kişi oluşturma (Imagen için) gibi model parametrelerini yapılandırın.
- Zararlı olarak değerlendirilebilecek yanıtlar alma olasılığını ayarlamak için güvenlik ayarlarını kullanın.
Vertex AI in Firebase ile ilgili deneyiminiz hakkında geri bildirim verme