Method: models.generateMessage

Genera una risposta dal modello con un input MessagePrompt.

Richiesta HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateMessage

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
model

string

Obbligatorio. Il nome del modello da utilizzare.

Formato: name=models/{model}.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "prompt": {
    object (MessagePrompt)
  },
  "temperature": number,
  "candidateCount": integer,
  "topP": number,
  "topK": integer
}
Campi
prompt

object (MessagePrompt)

Obbligatorio. L'input testuale strutturato fornito al modello come prompt.

Dato un prompt, il modello restituirà quello che prevede essere il messaggio successivo nella discussione.
temperature

number

Campo facoltativo. Controlla la casualità dell'output.

I valori possono essere superiori a [0.0,1.0] inclusi. Un valore più vicino a 1.0 produrrà risposte più variegate, mentre un valore più vicino a 0.0 genererà in genere risposte meno sorprendenti da parte del modello.
candidateCount

integer

Campo facoltativo. Il numero di messaggi di risposta generati da restituire.

Questo valore deve essere compreso tra [1, 8]. Se non viene configurato, il valore predefinito sarà 1.
topP

number

Campo facoltativo. La probabilità cumulativa massima di token da considerare durante il campionamento.

Il modello utilizza il campionamento combinato di Top-k e nucleo.

Il campionamento del nucleo considera l'insieme più piccolo di token la cui somma di probabilità è almeno topP.
topK

integer

Campo facoltativo. Il numero massimo di token da considerare durante il campionamento.

Il modello utilizza il campionamento combinato di Top-k e nucleo.

Il campionamento Top-K considera l'insieme di topK token più probabili.

Corpo della risposta

La risposta dal modello.

Sono inclusi i messaggi dei candidati e la cronologia delle conversazioni sotto forma di messaggi in ordine cronologico.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "candidates": [
    {
      object (Message)
    }
  ],
  "messages": [
    {
      object (Message)
    }
  ],
  "filters": [
    {
      object (ContentFilter)
    }
  ]
}
Campi
candidates[]

object (Message)

Messaggi di risposta dei candidati dal modello.
messages[]

object (Message)

La cronologia delle conversazioni utilizzata dal modello.
filters[]

object (ContentFilter)

Un insieme di metadati del filtro dei contenuti per il testo del prompt e della risposta.

Indica quali SafetyCategory hanno bloccato un candidato per questa risposta, il valore HarmProbability più basso che ha attivato un blocco e l'impostazione HarmThreshold per la categoria in questione.

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.