---
title: "Usa Gemini in OpenClaw tramite RunAPI — Guida API LLM"
url: "https://runapi.ai/it/openclaw-gemini.md"
canonical: "https://runapi.ai/it/openclaw-gemini"
locale: "it"
model: "gemini"
---

# Usa Gemini in OpenClaw.

Google Gemini è disponibile tramite l'endpoint OpenAI-compatibile di RunAPI — Gemini 3.5 Flash per una latenza del primo token inferiore a 100ms, 3.x Pro per il ragionamento complesso e 2.5 Pro per i carichi di lavoro in produzione. OpenClaw lo tratta come un altro modello OpenAI-compatibile, quindi la stessa configurazione del provider e la RUNAPI_API_KEY che alimenta GPT chiamano anche Gemini. Nessun progetto Google Cloud necessario, nessun account di servizio, nessuna configurazione Vertex AI.

## API example

```bash
curl -X POST https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.5-flash",
    "messages": [
      {"role": "system", "content": "You are a concise technical assistant."},
      {"role": "user", "content": "Explain the difference between gRPC and REST in three sentences."}
    ],
    "temperature": 0.7,
    "max_tokens": 256
  }'

```

### Response

```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gemini-3.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "gRPC uses HTTP/2 and Protocol Buffers for strongly-typed, multiplexed RPC calls with built-in code generation. REST uses HTTP/1.1 (or 2) with JSON payloads and relies on URL paths and HTTP verbs for resource semantics. gRPC is faster for service-to-service calls; REST is simpler to debug and more widely supported by browsers."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 34,
    "completion_tokens": 71,
    "total_tokens": 105
  }
}

```

## How it works

1. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY. Se hai già configurato RunAPI come provider OpenClaw, la stessa key e baseUrl funzionano per Gemini — cambia solo l'ID del modello. Nessuna credenziale Google Cloud necessaria.
2. **Chiama Gemini tramite chat completions** — Invia una richiesta POST a /v1/chat/completions con model impostato su gemini-3.5-flash. Passa un array messages con i ruoli system e user. L'endpoint accetta la stessa struttura OpenAI-compatibile che il tuo agente già usa per i modelli GPT.
3. **Leggi la risposta** — La risposta arriva in modo sincrono nel formato OpenAI chat completion. La risposta dell'assistente è in choices[0].message.content, con l'utilizzo dei token nell'oggetto usage. Per lo streaming, imposta stream su true e analizza gli eventi SSE.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. gemini-3.5-flash, gemini-2.5-flash, gemini-2.5-pro, gemini-3-flash-preview, gemini-3-pro-preview, o gemini-3.1-pro-preview. |
| `messages` | `array` | Obbligatorio. Array di oggetti messaggio con i campi role (system, user, assistant) e content. |
| `temperature` | `number` | Facoltativo. Temperatura di campionamento tra 0 e 2. Valori più bassi producono output più deterministico. Il valore predefinito varia per modello. |
| `max_tokens` | `integer` | Facoltativo. Numero massimo di token da generare nella risposta. |
| `stream` | `boolean` | Facoltativo. Quando true, la risposta viene inviata in streaming come server-sent events. Ogni evento contiene un delta con contenuto parziale. |
| `top_p` | `number` | Facoltativo. Soglia di nucleus sampling tra 0 e 1. Alternativa alla temperature per controllare la casualità dell'output. |

## FAQ

### Posso usare Google Gemini in OpenClaw senza un progetto Google Cloud?

Sì. RunAPI fornisce accesso a Gemini tramite il suo endpoint OpenAI-compatibile. Hai bisogno solo di una RUNAPI_API_KEY — nessun progetto Google Cloud, nessun account di servizio JSON, nessuna configurazione di fatturazione Vertex AI.

### Quali modelli Gemini sono disponibili tramite RunAPI?

RunAPI offre Gemini 3.5 Flash (più recente, più veloce), Gemini 2.5 Flash, Gemini 2.5 Pro, Gemini 3 Flash Preview, Gemini 3 Pro Preview e Gemini 3.1 Pro Preview. Passa lo slug della versione come parametro model — ad esempio, gemini-3.5-flash o gemini-2.5-pro.

### Come funziona il pricing di Gemini su RunAPI?

Gemini è fatturato per token su RunAPI con prezzi pay-as-you-go. I token di input e output sono misurati separatamente. Nessun abbonamento mensile, nessuna spesa minima. Consulta la pagina dei prezzi di RunAPI per le tariffe aggiornate per milione di token.

### Posso passare tra Gemini e GPT nella stessa sessione OpenClaw?

Sì. Entrambi usano la stessa configurazione del provider RunAPI e la stessa API key. Cambia il parametro model da gemini-3.5-flash a gpt-5.5 (o qualsiasi altro modello RunAPI) senza riconfigurare il provider. OpenClaw seleziona i modelli per ogni richiesta.

### Gemini tramite RunAPI supporta le risposte in streaming?

Sì. Imposta stream su true nel corpo della richiesta. RunAPI invia in streaming le risposte Gemini come server-sent events in formato delta OpenAI-compatibile, quindi OpenClaw li elabora allo stesso modo in cui gestisce lo streaming GPT.


## Links

- [Guida di configurazione di OpenClaw →](https://runapi.ai/it/openclaw)
- [Modelli Gemini →](https://runapi.ai/it/models/gemini)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)