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.

La piattaforma di agenti Gemini Enterprise 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 dalla piattaforma Google Cloud.

Di recente abbiamo semplificato la migrazione tra questi servizi. Sia l'API Gemini Developer sia l'API Gemini Enterprise Agent Platform sono ora accessibili tramite l'SDK Google Gen AI unificato.

Confronto del codice

Questa pagina mostra i confronti del codice affiancati tra le guide di avvio rapido dell'API Gemini Developer e di Gemini Enterprise Agent Platform per la generazione di testo.

Python

Puoi accedere sia all'API Gemini Developer sia ai servizi della piattaforma agentica Gemini Enterprise 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-flash-preview", contents="Explain how AI works in a few words"
)
print(response.text)

API della piattaforma agentica Gemini Enterprise

from google import genai

client = genai.Client(
    vertexai=True, project='your-project-id', location='us-central1'
)

response = client.models.generate_content(
    model="gemini-3-flash-preview", 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 della piattaforma agentica Gemini Enterprise 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-flash-preview",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

API della piattaforma agentica Gemini Enterprise

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-flash-preview",
    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 della piattaforma agentica Gemini Enterprise 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-flash-preview", genai.Text("Tell me about New York?"), nil)

}

API della piattaforma agentica Gemini Enterprise

import (
  "context"
  "encoding/json"
  "fmt"
  "log"
  "google.golang.org/genai"
)

// Your GCP project
const project = "your-project"

// A GCP 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-flash-preview", 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 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