Riferimento API Gemini

Questo riferimento API descrive le API unarie, di streaming e in tempo reale che puoi utilizzare per interagire con i modelli Gemini. Puoi utilizzare le API REST in qualsiasi ambiente che supporti le richieste HTTP. Consulta la Guida introduttiva per scoprire come iniziare a utilizzare la tua prima chiamata API. Se stai cercando i riferimenti per i nostri SDK e librerie specifici per lingua, vai al link per quella lingua nel riquadro di navigazione a sinistra in Riferimenti SDK.

Endpoint principali

L'API Gemini è organizzata intorno ai seguenti endpoint principali:

• Interazioni (CreateInteraction) (consigliato): La primitiva standard consigliata per la creazione con Gemini, ottimizzata per flussi di lavoro agentici, gestione dello stato lato server e conversazioni complesse multimodali e a più turni.
• Generazione di contenuti standard (generateContent): Un endpoint REST standard che elabora la tua richiesta e restituisce la risposta completa del modello in un unico pacchetto. Questa opzione è ideale per attività non interattive in cui puoi attendere l'intero risultato.
• Generazione di contenuti in streaming (streamGenerateContent): utilizza Server-Sent Events (SSE) per inviarti i blocchi della risposta man mano che vengono generati. In questo modo, l'esperienza è più veloce e interattiva per applicazioni come i chatbot.
• API Live (BidiGenerateContent): un'API stateful basata su WebSocket per lo streaming bidirezionale, progettata per casi d'uso conversazionali in tempo reale.
• Modalità batch (batchGenerateContent): un endpoint REST standard per l'invio di batch di richieste generateContent.
• Embeddings (embedContent): un endpoint REST standard che genera un vettore di text embedding dall'input Content.
• API Gen Media:endpoint per la generazione di contenuti multimediali con i nostri modelli specializzati, come Imagen per la generazione di immagini e Veo per la generazione di video. Gemini dispone anche di queste funzionalità integrate, a cui puoi accedere utilizzando l'API generateContent.
• API della piattaforma:endpoint di utilità che supportano funzionalità di base come il caricamento di file e il conteggio dei token.

Autenticazione

Tutte le richieste all'API Gemini devono includere un'intestazione x-goog-api-key con la tua chiave API. Creane una con pochi clic in Google AI Studio.

Di seguito è riportato un esempio di richiesta con la chiave API inclusa nell'intestazione:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

Per istruzioni su come trasmettere la chiave all'API utilizzando gli SDK Gemini, consulta la guida Utilizzo delle chiavi API Gemini.