API Gemini Developer e piattaforma agentica Gemini Enterprise

Quando sviluppa soluzioni di AI generativa con Gemini, Google offre due prodotti API: l'API Gemini Developer e l'API Gemini Enterprise Agent Platform.

L'API Gemini Developer offre il percorso più rapido per creare, mettere in produzione e scalare le applicazioni basate su Gemini. La maggior parte degli sviluppatori dovrebbe utilizzare l'API Gemini Developer, a meno che non siano necessari controlli aziendali specifici.

Gemini Enterprise Agent Platform offre un ecosistema completo di funzionalità e servizi pronti per l'uso aziendale per la creazione e il deployment di applicazioni di AI generativa supportate da Google Cloud.

Di recente abbiamo semplificato la migrazione tra questi servizi. L'API Gemini Developer e l'API Gemini Enterprise Agent Platform sono ora accessibili tramite l'SDK Google GenAI unificato e l'API Interactions.

Confronto del codice: API Interactions (consigliate)

L'API Interactions è il modo consigliato per creare con i modelli e gli agenti Gemini. Gli esempi seguenti confrontano la generazione di testo tra l'API Gemini Developer e Gemini Enterprise Agent Platform.

Python

Puoi accedere sia all'API Gemini Developer sia ai servizi Gemini Enterprise Agent Platform tramite la libreria google-genai (>= 2.3.0). Consulta la pagina Librerie per istruzioni su come installare 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 Gemini Enterprise Agent Platform

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 e TypeScript

Puoi accedere sia all'API Gemini Developer sia ai servizi Gemini Enterprise Agent Platform tramite la libreria @google/genai (>= 2.3.0). Consulta la pagina librerie per istruzioni su come installare @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 Gemini Enterprise Agent Platform

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

Confronto del codice: API generateContent

Sebbene l'API Interactions sia consigliata per i nuovi progetti, l'API generateContent rimane supportata.

Python

Puoi accedere sia all'API Gemini Developer sia ai servizi Gemini Enterprise Agent Platform tramite la libreria google-genai. Consulta la pagina Librerie per istruzioni su come installare 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 Gemini Enterprise Agent Platform

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 e TypeScript

Puoi accedere sia all'API Gemini Developer sia ai servizi Gemini Enterprise Agent Platform tramite la libreria @google/genai. Consulta la pagina Librerie per istruzioni su come installare @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 Gemini Enterprise Agent Platform

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

Puoi accedere sia all'API Gemini Developer sia ai servizi Gemini Enterprise Agent Platform tramite la libreria google.golang.org/genai. Consulta la pagina Librerie per istruzioni su come installare 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 Gemini Enterprise Agent Platform

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)

}

Altri casi d'uso e piattaforme

Consulta le guide specifiche per i casi d'uso nella documentazione dell'API Gemini Developer e nella documentazione di Gemini Enterprise Agent Platform per altre piattaforme e altri casi d'uso.

Considerazioni sulla migrazione

Quando esegui la migrazione:

Se non hai più bisogno di utilizzare la chiave API Gemini per l'API Gemini Developer, segui le best practice per la sicurezza ed eliminala.

Per eliminare una chiave API:

  1. Apri la pagina Credenziali API Google Cloud.

  2. Individua la chiave API che vuoi eliminare e fai clic sull'icona Azioni.

  3. Seleziona Elimina chiave API.

  4. Nella finestra modale Elimina credenziale, seleziona Elimina.

    L'eliminazione di una chiave API richiede alcuni minuti per la propagazione. Al termine della propagazione, tutto il traffico che utilizza la chiave API eliminata viene rifiutato.

Passaggi successivi