Lorsque vous développez des solutions d'IA générative avec Gemini, Google propose deux produits API : l'API Gemini Developer et l'API de la plate-forme Gemini.
L'API Gemini Developer offre le moyen le plus rapide de créer, de mettre en production et de faire évoluer des applications optimisées par Gemini. La plupart des développeurs doivent utiliser l'API Gemini Developer, sauf s'ils ont besoin de contrôles d'entreprise spécifiques.
La plate-forme Gemini offre un écosystème complet de fonctionnalités et de services adaptés aux entreprises pour créer et déployer des applications d'IA générative soutenues par Google Cloud.
Nous avons récemment simplifié la migration entre ces services. L'API Gemini Developer et l'API de la plate-forme Gemini sont désormais accessibles via le SDK Google GenAI unifié et l'API Interactions.
Comparaison de code : API Interactions (recommandée)
L'API Interactions est la méthode recommandée pour créer des applications avec les modèles et les agents Gemini. Les exemples suivants comparent la génération de texte entre l'API Gemini Developer et la plate-forme Gemini.
Python
Vous pouvez accéder à l'API Gemini Developer et aux services de la plate-forme Gemini via la bibliothèque google-genai (>= 2.3.0). Consultez la page Bibliothèques pour savoir comment installer google-genai.
API Gemini Developer
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explain how AI works in a few words",
)
print(interaction.output_text)
API de la plate-forme Gemini
from google import genai
client = genai.Client(
enterprise=True, project="your-project-id", location="global"
)
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explain how AI works in a few words",
)
print(interaction.output_text)
JavaScript et TypeScript
Vous pouvez accéder à l'API Gemini Developer et aux services de la plate-forme Gemini via la bibliothèque @google/genai (>= 2.3.0). Consultez la page Bibliothèques pour savoir comment installer @google/genai.
API Gemini Developer
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);
API de la plate-forme Gemini
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
enterprise: true,
project: "your_project",
location: "global",
});
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);
Comparaison de code : API generateContent
Bien que l'API Interactions soit recommandée pour les nouveaux projets, l'API generateContent reste compatible.
Python
Vous pouvez accéder à l'API Gemini Developer et aux services de la plate-forme Gemini via la bibliothèque google-genai. Consultez la page Bibliothèques pour savoir comment installer google-genai.
API Gemini Developer
from google import genai
client = genai.Client()
response = client.models.generate_content(
model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)
API de la plate-forme Gemini
from google import genai
client = genai.Client(
vertexai=True, project='your-project-id', location='us-central1'
)
response = client.models.generate_content(
model="gemini-3.8-flash", contents="Explain how AI works in a few words"
)
print(response.text)
JavaScript et TypeScript
Vous pouvez accéder aux services de l'API Gemini Developer et de la plate-forme Gemini via la bibliothèque @google/genai. Consultez la page Bibliothèques pour savoir comment installer @google/genai.
API Gemini Developer
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3.8-flash",
contents: "Explain how AI works in a few words",
});
console.log(response.text);
}
main();
API de la plate-forme Gemini
import { GoogleGenAI } from '@google/genai';
const ai = new GoogleGenAI({
vertexai: true,
project: 'your_project',
location: 'your_location',
});
async function main() {
const response = await ai.models.generateContent({
model: "gemini-3.8-flash",
contents: "Explain how AI works in a few words",
});
console.log(response.text);
}
main();
Go
Vous pouvez accéder aux services de l'API Gemini Developer et de la plate-forme Gemini via la bibliothèque google.golang.org/genai. Consultez la page Bibliothèques pour savoir comment installer google.golang.org/genai.
API Gemini Developer
import (
"context"
"encoding/json"
"fmt"
"log"
"google.golang.org/genai"
)
// Your Google API key
const apiKey = "your-api-key"
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, nil)
if err != nil {
log.Fatal(err)
}
// Call the GenerateContent method.
result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)
}
API de la plate-forme Gemini
import (
"context"
"encoding/json"
"fmt"
"log"
"google.golang.org/genai"
)
// Your Google Cloud project
const project = "your-project"
// A Google Cloud location like "us-central1"
const location = "some-gcp-location"
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, &genai.ClientConfig
{
Project: project,
Location: location,
Backend: genai.BackendVertexAI,
})
// Call the GenerateContent method.
result, err := client.Models.GenerateContent(ctx, "gemini-3.8-flash", genai.Text("Tell me about New York?"), nil)
}
Autres cas d'utilisation et plates-formes
Pour d'autres plates-formes et cas d'utilisation, consultez les guides spécifiques aux cas d'utilisation dans la documentation de l'API Gemini Developer et la documentation de la plate-forme Gemini.
Considérations sur la migration
Lorsque vous migrez :
Vous devrez utiliser des comptes de service Google Cloud pour vous authentifier. Pour en savoir plus, consultez la documentation sur la plate-forme Gemini.
Vous pouvez utiliser votre projet Google Cloud existant (celui utilisé pour générer votre clé API) ou créer un nouveau projet Google Cloud.
Les régions prises en charge peuvent différer entre l'API Gemini Developer et l'API de la plate-forme Gemini. Pendant la période d'aperçu, l'API Interactions sur la plate-forme Gemini n'est compatible qu'avec le point de terminaison
global(location="global"). Consultez la liste des régions prises en charge pour l'IA générative sur Google Cloud.Tous les modèles que vous avez créés dans Google AI Studio doivent être réentraînés dans la plate-forme Gemini.
Si vous n'avez plus besoin d'utiliser votre clé API Gemini pour l'API Gemini Developer, suivez les bonnes pratiques de sécurité et supprimez-la.
Pour supprimer une clé API :
Ouvrez la page Identifiants de l'API Google Cloud.
Recherchez la clé API que vous souhaitez supprimer, puis cliquez sur l'icône Actions.
Sélectionnez Supprimer la clé API.
Dans la fenêtre Supprimer l'identifiant, sélectionnez Supprimer.
Propager la suppression d'une clé API prend quelques minutes. Une fois la propagation terminée, tout trafic utilisant la clé API supprimée est rejeté.
Étapes suivantes
- Consultez le guide du développeur sur l'API Interactions sur la plate-forme Gemini.
- Consultez la présentation de l'IA générative sur la plate-forme Gemini pour en savoir plus sur les solutions d'IA générative sur la plate-forme Gemini.