Method: tunedModels.generateContent

Menghasilkan respons dari model yang diberi GenerateContentRequest input.

Permintaan HTTP

POST https://generativelanguage.googleapis.com/v1beta/{model=tunedModels/*}:generateContent

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
model

string

Wajib. Nama Model yang akan digunakan untuk membuat penyelesaian.

Format: name=models/{model}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  }
}
Kolom
contents[]

object (Content)

Wajib. Konten percakapan saat ini dengan model.

Untuk kueri satu giliran, ini adalah instance tunggal. Untuk kueri banyak giliran, ini adalah kolom berulang yang berisi histori percakapan + permintaan terbaru.

tools[]

object (Tool)

Opsional. Daftar Tools yang dapat digunakan model untuk membuat respons berikutnya.

Tool adalah potongan kode yang memungkinkan sistem berinteraksi dengan sistem eksternal untuk melakukan suatu tindakan, atau serangkaian tindakan, di luar pengetahuan dan cakupan model. Satu-satunya alat yang didukung saat ini adalah Function.

toolConfig

object (ToolConfig)

Opsional. Konfigurasi alat untuk Tool apa pun yang ditentukan dalam permintaan.

safetySettings[]

object (SafetySetting)

Opsional. Daftar instance SafetySetting unik untuk memblokir konten yang tidak aman.

Kebijakan ini akan diterapkan pada GenerateContentRequest.contents dan GenerateContentResponse.candidates. Tidak boleh ada lebih dari satu setelan untuk setiap jenis SafetyCategory. API akan memblokir konten dan respons apa pun yang gagal memenuhi nilai minimum yang ditetapkan oleh setelan ini. Daftar ini mengganti setelan default untuk setiap SafetyCategory yang ditentukan di Setelan Keamanan. Jika tidak ada SafetySetting untuk SafetyCategory tertentu yang diberikan dalam daftar, API akan menggunakan setelan keamanan default untuk kategori tersebut. Kategori bahaya HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_ExpLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT didukung.

systemInstruction

object (Content)

Opsional. Petunjuk sistem kumpulan developer. Saat ini, hanya teks.

generationConfig

object (GenerationConfig)

Opsional. Opsi konfigurasi untuk pembuatan dan output model.

Isi respons

Jika berhasil, isi respons akan berisi instance GenerateContentResponse.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • 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

Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.