Method: models.generateContent

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

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
model

string

To pole jest wymagane. Nazwa zasobu (Model), która służy do wygenerowania ukończenia.

Format: name=models/{model}.

Treść żądania

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

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

object (Content)

To pole jest wymagane. Treść bieżącej rozmowy z modelem.

W przypadku zapytań jednoetapowych jest to pojedyncze wystąpienie. W przypadku zapytań wieloetapowych jest to pole powtarzane zawierające historię rozmowy i ostatnie żądanie.
safetySettings[]

object (SafetySetting)

Opcjonalnie. Lista unikalnych instancji SafetySetting służących do blokowania niebezpiecznych treści.

Będzie to obowiązywać GenerateContentRequest.contents i GenerateContentResponse.candidates. Dla każdego typu SafetyCategory powinno być tylko 1 ustawienie. Interfejs API będzie blokować wszelkie treści i odpowiedzi, które nie osiągnęły progów określonych przez te ustawienia. Ta lista zastępuje ustawienia domyślne w przypadku każdego elementu SafetyCategory określonego w ustawieniach zabezpieczeń. Jeśli na liście nie ma parametru SafetySetting dla danego parametru SafetyCategory, interfejs API użyje domyślnego ustawienia bezpieczeństwa tej kategorii. Obsługiwane są kategorie szkodliwych treści: HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT.
generationConfig

object (GenerationConfig)

Opcjonalnie. Opcje konfiguracji generowania modelu i danych wyjściowych.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu GenerateContentResponse.

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.