L'API Gemini è il percorso più rapido dal prompt alla produzione con Gemini, Veo, Nano Banana e altro ancora. Ti consente di integrare questi modelli generativi nelle tue applicazioni per generare testo e immagini, analizzare input multimodali e creare agenti di conversazione.
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-argon",
input="Explain how AI works in a few words"
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
model: "gemini-4-argon",
input: "Explain how AI works in a few words",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateModelInteraction params =
CreateModelInteraction.builder()
.model(Model.of("gemini-4-argon"))
.input(InteractionsInput.of("Explain how AI works in a few words"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();
System.out.println(interaction.outputText().orElse(""));
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
"google.golang.org/genai/interactions/models/interactions"
"google.golang.org/genai/interactions/models/operations"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, nil)
if err != nil {
log.Fatal(err)
}
res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
Model: interactions.Model("gemini-4-argon"),
Input: interactions.NewInteractionsInput("Explain how AI works in a few words"),
}),
})
if err != nil {
log.Fatal(err)
}
if res.Interaction.OutputText != nil {
fmt.Println(*res.Interaction.OutputText)
}
}
REST
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gemini-4-argon",
"input": "Explain how AI works in a few words"
}'
Scopri i modelli
Visualizza tuttoGemini 4 Argon Novità
Il nostro modello di ragionamento di punta con una finestra contestuale condivisa da 1 milione di token e decodifiche lunghe fino a 1 milione di token.
Gemini 3.8 Flash Nuovo
Il nostro modello Flash più intelligente, progettato per l'ingegneria del software a lungo termine, gli agenti autonomi e i workflow aziendali complessi.
Gemini 3.8 Flash TTS Nuovo
Modello di sintesi vocale di livello professionale con recitazione espressiva, progettazione di voci personalizzate e replica vocale.
Gemini 3.5 Flash-Lite
Modello ad alto volume e sensibile ai costi, ottimizzato per attività di subagenti a bassa latenza e throughput elevato.
Nano Banana
Modelli all'avanguardia per la generazione e la modifica di immagini.
Gemini Omni Flash
Il nostro modello all'avanguardia per la generazione e la modifica di video.
Gemini 3.5 Transcribe Novità
Modello di conversione della voce in testo a bassa latenza con rilevamento della lingua basato sugli enunciati, diarizzazione degli interlocutori e timestamp delle parole.
Gemini Robotics
Un modello linguistico visivo (VLM) che porta le capacità agentiche di Gemini nella robotica e consente un ragionamento avanzato nel mondo fisico.
Esplora le funzionalità
Generazione di immagini
Genera e modifica immagini altamente contestuali in modo nativo con Nano Banana.
Contesto lungo
Inserisci milioni di token nei modelli Gemini e ricava informazioni da immagini, video e documenti non strutturati.
Output strutturati
Vincola Gemini a rispondere con JSON, un formato dei dati strutturato adatto all'elaborazione automatizzata.
Chiamata di funzione
Crea Agentic Workflows collegando Gemini ad API e strumenti esterni.
Generazione di video con Gemini Omni Flash
Crea contenuti video di alta qualità da prompt di testo o immagini con il nostro modello allo stato dell'arte.
Agenti vocali con l'API Live
Crea applicazioni e agenti vocali in tempo reale con l'API Live.
Strumenti
Connetti Gemini al mondo tramite strumenti integrati come Ricerca Google, Contesto URL, Google Maps, esecuzione di codice e utilizzo del computer.
Comprensione dei documenti
Elabora fino a 1000 pagine di file PDF con comprensione multimodale completa o altri tipi di file basati su testo.
Ragionamento
Scopri come le funzionalità di pensiero migliorano il ragionamento per agenti e attività complessi.
Crea agenti
Gli agenti gestiti forniscono a Gemini uno spazio di lavoro per pianificare e completare le attività in autonomia. In una singola richiesta, Gemini può scrivere ed eseguire codice, cercare sul web e creare file in un ambiente sandbox ospitato. Inizia con il nostro agente Antigravity predefinito o personalizzalo con le tue istruzioni e i tuoi strumenti.
Python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
agent="antigravity-preview-09-2026",
input=(
"Research the top 5 sustainable fashion brands, "
"compare their materials and pricing tiers, and "
"build an interactive dashboard in analysis.html."
),
environment="remote"
)
print(interaction.output_text)
JavaScript
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({});
const interaction = await ai.interactions.create({
agent: "antigravity-preview-09-2026",
input:
"Research the top 5 sustainable fashion brands, " +
"compare their materials and pricing tiers, and " +
"build an interactive dashboard in analysis.html.",
environment: "remote",
});
console.log(interaction.output_text);
Java
import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.AgentOption;
import com.google.genai.gaos.models.interactions.CreateAgentInteraction;
import com.google.genai.gaos.models.interactions.CreateAgentInteractionEnvironment;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;
Client client = new Client();
CreateAgentInteraction params =
CreateAgentInteraction.builder()
.agent(AgentOption.of("antigravity-preview-09-2026"))
.input(
InteractionsInput.of(
"Research the top 5 sustainable fashion brands, "
+ "compare their materials and pricing tiers, and "
+ "build an interactive dashboard in analysis.html."))
.environment(CreateAgentInteractionEnvironment.of("remote"))
.build();
Interaction interaction =
client.interactions.create(CreateInteractionRequestBody.of(params))
.interaction()
.get();
System.out.println(interaction.outputText().orElse(""));
Go
package main
import (
"context"
"fmt"
"log"
"google.golang.org/genai"
"google.golang.org/genai/interactions/models/interactions"
"google.golang.org/genai/interactions/models/operations"
)
func main() {
ctx := context.Background()
client, err := genai.NewClient(ctx, nil)
if err != nil {
log.Fatal(err)
}
res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
Body: operations.NewCreateInteractionRequestBody(interactions.CreateAgentInteraction{
Agent: interactions.AgentOption("antigravity-preview-09-2026"),
Input: interactions.NewInteractionsInput(
"Research the top 5 sustainable fashion brands, " +
"compare their materials and pricing tiers, and " +
"build an interactive dashboard in analysis.html.",
),
Environment: genai.Ptr(interactions.NewCreateAgentInteractionEnvironment("remote")),
}),
})
if err != nil {
log.Fatal(err)
}
if res.Interaction.OutputText != nil {
fmt.Println(*res.Interaction.OutputText)
}
}
REST
curl -X POST \
"https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"agent": "antigravity-preview-09-2026",
"input": "Research the top 5 sustainable fashion brands, compare their materials and pricing tiers, and build an interactive dashboard in analysis.html.",
"environment": "remote"
}'
API Interactions
L'API Interactions è diventata la nostra interfaccia predefinita a partire da giugno 2026 ed è il modo migliore per creare con i modelli e gli agenti Gemini in futuro. Se stai avviando un nuovo progetto, devi utilizzare l'API Interactions. Sebbene sia ancora supportata, l'API generateContent è ora considerata legacy.
Panoramica delle interazioni
Scopri come l'API Interactions gestisce lo stato della conversazione, i messaggi e i formati di output.
Guida alla migrazione
Guida passo passo per la transizione del codice da generateContent all'API Interactions.
Streaming
Esegui lo streaming di token in tempo reale, pensieri incrementali ed eventi di chiamata degli strumenti.