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 le nostre librerie e SDK specifici per la lingua, vai al link per quella lingua nella 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 i flussi di lavoro agentici, la gestione dello stato lato server e conversazioni multimodali, e multi-turn complesse.
• Generazione di contenuti standard (generateContent): un endpoint REST standard che elabora la richiesta e restituisce la risposta completa del modello in un unico pacchetto. È ideale per le attività non interattive in cui puoi attendere l'intero risultato.
• Generazione di contenuti in streaming (streamGenerateContent): utilizza gli eventi inviati dal server (SSE) per inviarti blocchi della risposta man mano che vengono generati. In questo modo, l'esperienza è più rapida 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.
• Embedding (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 ha anche 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 passare la chiave all'API utilizzando gli SDK Gemini, consulta la guida Utilizzare le chiavi API Gemini.