API Gemini Developer e piattaforma agentica Gemini Enterprise

Quando sviluppi soluzioni di AI generativa con Gemini, Google offre due prodotti API: l'API Gemini Developer e l'API della piattaforma agentica Gemini Enterprise.

L'API Gemini Developer fornisce 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 sia necessario utilizzare controlli aziendali specifici.

La piattaforma agentica 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 basate su Google Cloud.

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

Confronto del codice

Questa pagina contiene confronti di codice affiancati tra le guide rapide dell'API Gemini Developer e della piattaforma agentica Gemini Enterprise per la generazione di testo.

Python

Puoi accedere ai servizi dell'API Gemini Developer e della piattaforma agentica Gemini Enterprise tramite la libreria google-genai. Per istruzioni su come installare google-genai, consulta la pagina delle librerie.

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 ai servizi dell'API Gemini Developer e della piattaforma agentica Gemini Enterprise tramite la libreria @google/genai. Per istruzioni su come installare @google/genai, consulta la pagina delle librerie.

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

Vai

Puoi accedere ai servizi dell'API Gemini Developer e della piattaforma agentica Gemini Enterprise tramite la libreria google.golang.org/genai. Per istruzioni su come installare google.golang.org/genai, consulta la pagina delle librerie.

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

Per altre piattaforme e altri casi d'uso, consulta le guide specifiche per i casi d'uso nella documentazione dell'API Gemini Developer e nella documentazione della piattaforma agentica Gemini Enterprise.

Considerazioni sulla migrazione

Durante la migrazione:

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

Per eliminare una chiave API:

  1. Apri la pagina Credenziali API di Google Cloud.

  2. Trova 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.

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

Passaggi successivi