Method: tunedModels.generateContent

以提供輸入 GenerateContentRequest 的方式從模型產生回應。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
model

string

必要欄位。要用來產生完成的 Model 名稱。

格式:name=models/{model}

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "contents": [
    {
      object (Content)
    }
  ],
  "tools": [
    {
      object (Tool)
    }
  ],
  "toolConfig": {
    object (ToolConfig)
  },
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "systemInstruction": {
    object (Content)
  },
  "generationConfig": {
    object (GenerationConfig)
  }
}
欄位
contents[]

object (Content)

必要欄位。目前與模型的對話內容,

如為單輪查詢,這是單一執行個體。如為多輪查詢,這是重複欄位,內含對話記錄 + 最新要求。

tools[]

object (Tool)

選用設定。模型可能用來產生下一個回應的 Tools 清單。

Tool 是一段程式碼,可讓系統與外部系統互動,以便在模型的知識和範圍外執行動作或一組動作。目前唯一支援的工具是 Function

toolConfig

object (ToolConfig)

選用設定。要求中指定的任何 Tool 的工具設定。

safetySettings[]

object (SafetySetting)

選用設定。用於封鎖不安全內容的專屬 SafetySetting 例項清單。

這項政策將在 GenerateContentRequest.contentsGenerateContentResponse.candidates 強制執行。每種 SafetyCategory 類型最多只能有一項設定。API 會封鎖不符合這些設定所設門檻的內容和回應。這份清單會覆寫 SafetySettings 內每個 SafetyCategory 的預設設定。如果清單中指定的 SafetyCategory 沒有 SafetySetting,API 就會使用該類別的預設安全設定。支援傷害類別 HARM_CATEGORY_HATE_SPEECH、HARM_CATEGORY_SEXUALLY_EXPLICIT、HARM_CATEGORY_DANGEROUS_CONTENT、HARM_CATEGORY_HARASSMENT。

systemInstruction

object (Content)

選用設定。開發人員集系統指示。目前僅支援文字。

generationConfig

object (GenerationConfig)

選用設定。模型產生和輸出的設定選項。

回應主體

如果成功,回應主體會包含 GenerateContentResponse 的執行例項。

授權範圍

需要下列其中一種 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

詳情請參閱驗證總覽