Method: models.generateMessage

Generuje odpowiedź z modelu z podaną wartością wejściową MessagePrompt.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
model

string

To pole jest wymagane. Nazwa modelu, którego chcesz użyć.

Format: name=models/{model}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

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

object (MessagePrompt)

To pole jest wymagane. Uporządkowane dane wejściowe tekstowe przekazywane modelowi jako prompt.

Po otrzymaniu promptu model zwróci to, co przewiduje, że będzie to następna wiadomość w dyskusji.
temperature

number

Opcjonalnie. Określa losowość danych wyjściowych.

Wartości mogą się mieścić w zakresie do [0.0,1.0] włącznie. Wartość bliższa 1.0 daje bardziej zróżnicowane odpowiedzi, natomiast wartość bliższa 0.0 daje zwykle mniej zaskakujące odpowiedzi z modelu.
candidateCount

integer

Opcjonalnie. Liczba wygenerowanych odpowiedzi do zwrócenia.

Ta wartość musi mieścić się w zakresie [1, 8] włącznie. Jeśli zasada jest nieskonfigurowana, wartość domyślna to 1.
topP

number

Opcjonalnie. Maksymalne skumulowane prawdopodobieństwo, które tokeny należy wziąć pod uwagę podczas próbkowania.

Model wykorzystuje połączone próbkowanie górnego K i próbkowanie jądra.

Próbkowanie jądra uwzględnia najmniejszy zbiór tokenów, których suma prawdopodobieństwa wynosi co najmniej topP.
topK

integer

Opcjonalnie. Maksymalna liczba tokenów uwzględniana podczas próbkowania.

Model wykorzystuje połączone próbkowanie górnego K i próbkowanie jądra.

Próbkowanie górnego K uwzględnia zbiór topK najbardziej prawdopodobnych tokenów.

Treść odpowiedzi

Odpowiedź modelu.

Obejmuje to wiadomości od kandydatów i historię rozmowy w formie wiadomości uporządkowanych chronologicznie.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

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

object (Message)

Komunikaty z odpowiedziami o kandydatach z modelu.
messages[]

object (Message)

Historia rozmowy używana przez model.
filters[]

object (ContentFilter)

Zestaw metadanych filtrowania treści promptu i tekstu odpowiedzi.

Wskazuje on, które SafetyCategory zablokowały kandydata w tej odpowiedzi, najniższe HarmProbability, które spowodowało zablokowanie, oraz ustawienie progu zagrożenia dla tej kategorii.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.