Un’unica autenticazione, tutti i provider
Una sola chiave RunAPI sblocca l’intero catalogo. Niente account separati, niente rotazione delle chiavi per integrazione.
Testo
Google
Gemini API
Usa l'API Gemini tramite RunAPI con model skill, autenticazione unificata e prezzi pay-as-you-go.
# Base URL
https://runapi.ai
# Endpoints
POST /v1/chat/completions
POST /v1/responses
POST /v1/messages
POST /v1beta/models/{model}:generateContent
POST /v1beta/models/{model}:streamGenerateContent
curl https://runapi.ai/v1/chat/completions \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.8-flash",
"messages": [
{
"role": "user",
"content": "Analizza questa codebase e suggerisci tre miglioramenti delle prestazioni con esempi prima/dopo."
}
]
}'from openai import OpenAI
client = OpenAI(
base_url="https://runapi.ai/v1",
api_key="your-runapi-key"
)
response = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "Analizza questa codebase e suggerisci tre miglioramenti delle prestazioni con esempi prima/dopo."}]
)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://runapi.ai/v1",
apiKey: "your-runapi-key"
});
const response = await client.chat.completions.create({
model: "gemini-3.8-flash",
messages: [{ role: "user", content: "Analizza questa codebase e suggerisci tre miglioramenti delle prestazioni con esempi prima/dopo." }]
});OVERVIEW
Informazioni su Gemini
Gemini è la famiglia di modelli linguistici multimodali di grandi dimensioni di Google, con comprensione di testo, immagini, audio e codice. Disponibile nelle varianti Flash e Pro, gestisce attività che vanno dal riassunto rapido al ragionamento approfondito e al coding complesso.
Provider
Google
Modalità
Testo
Endpoint API Gemini
| Endpoint | Protocol |
|---|---|
POST /v1/chat/completions | OpenAI compatible |
POST /v1/responses | OpenAI Responses |
POST /v1/messages | Anthropic compatible |
POST /v1beta/models/{model}:generateContent | Gemini generateContent |
POST /v1beta/models/{model}:streamGenerateContent | Gemini streamGenerateContent |
Confronta tutte le varianti API
| Variante | Fatturazione | Prezzo | |
|---|---|---|---|
| gemini-2.5-flash | 1K token | Input $0.24 / 1M di token | Output $2.00 / 1M di token | Visualizza → |
| gemini-2.5-flash-lite | 1K token | Input $0.10 / 1M di token | Output $0.40 / 1M di token | Visualizza → |
| gemini-2.5-pro | 1K token | Input $1.00-$2.00 / 1M di token | Output $8.00-$12.00 / 1M di token | Visualizza → |
| gemini-3-flash-preview | 1K token | Input $0.40 / 1M di token | Output $2.40 / 1M di token | Visualizza → |
| gemini-3.1-flash-lite | 1K token | Input $0.25 / 1M di token | Output $1.50 / 1M di token | Visualizza → |
| gemini-3.1-pro-preview | 1K token | Input $1.60-$3.20 / 1M di token | Output $9.60-$14.40 / 1M di token | Visualizza → |
| gemini-3.5-flash | 1K token | Input $1.20 / 1M di token | Output $7.20 / 1M di token | Visualizza → |
| gemini-3.5-flash-lite | 1K token | Input $0.24 / 1M di token | Output $2.00 / 1M di token | Visualizza → |
| gemini-3.6-flash | 1K token | Input $0.60 / 1M di token | Output $3.00 / 1M di token | Visualizza → |
| gemini-3.7-flash | 1K token | Input $0.60 / 1M di token | Output $3.00 / 1M di token | Visualizza → |
| gemini-3.8-flash | 1K token | Input $0.60 / 1M di token | Output $3.00 / 1M di token | Visualizza → |
PRICING
Prezzi Gemini
| Endpoint | Risoluzione | Durata | Prezzo | |
|---|---|---|---|---|
| chat_completion | — | — | Input $0.24 / 1M di token | Output $2.00 / 1M di token |
Prezzi mostrati per gemini-2.5-flash. Le altre varianti mantengono i propri prezzi per endpoint.
Integrazione agenti
Esegui Gemini da un agente
COME FUNZIONA
Inizia con Gemini
-
Scegli il modello
Seleziona modello e variante adatti al tipo di output, al livello qualità e alla latenza target.
-
Configura
Imposta la tua chiave RunAPI e installa il model skill nel workspace di codice.
-
Implementa
Usa le istruzioni dello skill per aggiungere la feature modello dentro la tua applicazione.
-
Ricevi
Interroga per task ID, usa streaming dove supportato o gestisci il callback webhook.
CONTEXT
Che cos'è l'API Gemini?
Gemini è l'LLM multimodale di punta di Google, disponibile nelle varianti Flash (veloce) e Pro (ragionamento all'avanguardia). Tramite RunAPI tutti i modelli Gemini condividono la stessa struttura API e la stessa fatturazione.
Perché usare l'API Gemini tramite RunAPI
Prezzi e billing unificati
Prezzi per chiamata in USD, fatturati mensilmente. Le generazioni fallite non vengono addebitate.
Skill con schema
Schema tipizzati e note di setup sono inclusi nel model skill, così l'implementazione parte dal contratto corretto.
Domande su Gemini
Qual è la dimensione della finestra di contesto di Gemini?
Fino a 1 milione di token in tutte le varianti. Gestisce intere codebase, documenti lunghi e conversazioni multi-turno senza troncamento.
Quali modalità di input accetta Gemini?
Testo, immagini, audio e video. Puoi passare input multimodali in una singola richiesta per un ragionamento cross-modale.
Che cos'è il grounding con Google Search?
Gemini può basare le risposte sui risultati di Google Search in tempo reale, riducendo le allucinazioni per le query fattuali e sensibili al tempo.
Come si confrontano Flash e Pro?
Flash è ottimizzato per velocità e costi, ideale per attività ad alto volume. Pro offre un ragionamento più approfondito ed è più adatto ad analisi complesse in più passaggi.
Gemini supporta il function calling?
Sì — Gemini supporta il function calling strutturato con schemi JSON tipizzati, il che lo rende adatto a flussi agentici e all'uso di strumenti.
Da quale variante dovrei iniziare?
Scegli la variante più economica che soddisfa il tuo livello di qualità. La maggior parte dei team inizia con la variante veloce e passa alla pro per la produzione.
MODELLI SIMILI