Premiers pas avec l'API Gemini à l'aide de Vertex AI dans les SDK Firebase

Ce guide vous explique comment commencer à effectuer des appels à Vertex AI Gemini API directement à partir de votre application à l'aide du SDK Vertex AI in Firebase pour la plate-forme de votre choix.

Notez que vous pouvez également utiliser ce guide pour commencer à accéder aux modèles Imagen à l'aide des SDK Vertex AI in Firebase.

Prérequis

Ce guide part du principe que vous savez utiliser Xcode pour développer des applications pour les plates-formes Apple (comme iOS).

• Assurez-vous que votre environnement de développement et votre application pour les plates-formes Apple répondent aux exigences suivantes:

  • Xcode 15.2 ou version ultérieure
  • Votre application doit cibler iOS 15 ou version ultérieure, ou macOS 12 ou version ultérieure.

• (Facultatif) Découvrez l'application exemple.

  Téléchargez l'exemple d'application

  Vous pouvez tester rapidement le SDK, voir une implémentation complète de différents cas d'utilisation ou utiliser l'application exemple si vous ne disposez pas de votre propre application pour les plates-formes Apple. Pour utiliser l'application exemple, vous devez l'associer à un projet Firebase.

Étape 1: Configurer un projet Firebase et associer votre application à Firebase

Si vous disposez déjà d'un projet Firebase et d'une application connectée à Firebase

1. Dans la console Firebase, accédez à la page Build with Gemini (Développer avec Gemini).

2. Cliquez sur la fiche Vertex AI in Firebase pour lancer un workflow qui vous aide à effectuer les tâches suivantes:

   • Mettre à jour votre projet pour utiliser le forfait Blaze avec paiement à l'usage.

   • Activez les API requises dans votre projet (API Vertex AI et API Vertex AI in Firebase).

3. Passez à l'étape suivante de ce guide pour ajouter le SDK à votre application.

Si vous ne disposez pas encore d'un projet Firebase et d'une application connectée à Firebase

Étape 2: Ajouter le SDK

Une fois votre projet Firebase configuré et votre application connectée à Firebase (voir étape précédente), vous pouvez ajouter le SDK Vertex AI in Firebase à votre application.

Utilisez Swift Package Manager pour installer et gérer les dépendances Firebase.

La bibliothèque Vertex AI in Firebase permet d'accéder aux API pour interagir avec les modèles Gemini et Imagen. La bibliothèque est incluse dans le SDK Firebase pour les plates-formes Apple (firebase-ios-sdk).

1. Dans Xcode, à partir de votre projet d'application ouvert, accédez à File > Add Packages (Fichier > Ajouter des packages).

2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :

     https://github.com/firebase/firebase-ios-sdk
   

3. Sélectionnez la dernière version du SDK.

4. Sélectionnez la bibliothèque FirebaseVertexAI.

   Lorsque vous avez terminé, Xcode commence à résoudre et à télécharger automatiquement vos dépendances en arrière-plan.

Étape 3: Initialisez le service Vertex AI et le modèle génératif

Avant de pouvoir effectuer des appels d'API et d'inviter un modèle Gemini, vous devez initialiser le service Vertex AI et le modèle génératif.

1. Importez le module FirebaseVertexAI:

   import FirebaseVertexAI
   

2. Initialisez le service Vertex AI et le modèle génératif:

   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")
   

Une fois que vous avez terminé ce guide de démarrage, découvrez comment choisir un modèle et (facultatif) un emplacement adapté à votre cas d'utilisation et à votre application.

Étape 4: Envoyer une requête d'invite à un modèle

Maintenant que vous avez connecté votre application à Firebase, ajouté le SDK et initialisé le service Vertex AI et le modèle génératif, vous êtes prêt à envoyer une requête d'invite à un modèle Gemini.

Vous pouvez utiliser generateContent() pour générer du texte à partir d'une requête d'invite textuelle uniquement:

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.")

Qu'est-ce que tu sais faire d'autre ?

En savoir plus sur les modèles compatibles

Essayer d'autres fonctionnalités de Gemini API

• Découvrez comment générer du texte à partir de requêtes textuelles uniquement, y compris comment diffuser la réponse.
• Générer du texte à partir de requêtes multimodales (y compris du texte, des images, des PDF, des vidéos et de l'audio)
• Créez des conversations multitours (chat).
• Générez une sortie structurée (comme JSON) à partir d'invites textuelles et multimodales.
• Utilisez l'appel de fonction pour connecter les modèles génératifs à des systèmes et des informations externes.

Découvrez comment contrôler la génération de contenu.

• Comprendre la conception des requêtes, y compris les bonnes pratiques, les stratégies et les exemples de requêtes.
• Configurez les paramètres du modèle, comme la température et le nombre maximal de jetons de sortie (pour Gemini) ou le format et la génération de personnes (pour Imagen).
• Utilisez les paramètres de sécurité pour ajuster la probabilité d'obtenir des réponses pouvant être considérées comme nuisibles.

Envoyer des commentaires sur votre expérience avec Vertex AI in Firebase