Method: models.generateContent

Genera una risposta dal modello con un input GenerateContentRequest.

Richiesta HTTP

POST https://generativelanguage.googleapis.com/v1/{model=models/*}:generateContent

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
model

string

Obbligatorio. Il nome dell'elemento Model da utilizzare per generare il completamento.

Formato: name=models/{model}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
Campi
contents[]

object (Content)

Obbligatorio. I contenuti della conversazione corrente con il modello.

Per le query a turno singolo, si tratta di una singola istanza. Per le query in più passaggi, si tratta di un campo ripetuto che contiene la cronologia della conversazione e l'ultima richiesta.

safetySettings[]

object (SafetySetting)

Campo facoltativo. Un elenco di istanze SafetySetting univoche per bloccare contenuti non sicuri.

Questa impostazione verrà applicata nei seguenti paesi: GenerateContentRequest.contents e GenerateContentResponse.candidates. Per ogni tipo di SafetyCategory non deve essere presente più di un'impostazione. L'API bloccherà tutti i contenuti e le risposte che non soddisfano le soglie impostate da queste impostazioni. Questo elenco sostituisce le impostazioni predefinite per ogni SafetyCategory specificato nelle impostazioni di sicurezza. Se nell'elenco non è presente SafetySetting per un determinato SafetyCategory, l'API utilizzerà l'impostazione di sicurezza predefinita per quella categoria. Sono supportate le categorie di danni HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT e HARM_CATEGORY_HARASSMENT.

generationConfig

object (GenerationConfig)

Campo facoltativo. Opzioni di configurazione per la generazione e gli output del modello.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di GenerateContentResponse.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/generative-language
  • https://www.googleapis.com/auth/generative-language.tuning
  • https://www.googleapis.com/auth/generative-language.tuning.readonly
  • https://www.googleapis.com/auth/generative-language.retriever
  • https://www.googleapis.com/auth/generative-language.retriever.readonly

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.