Method: models.generateContent

在给定输入 GenerateContentRequest 的情况下，从模型生成回答。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
model

string

必需。用于生成补全的 Model 的名称。

格式：name=models/{model}。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "contents": [
    {
      object (Content)
    }
  ],
  "safetySettings": [
    {
      object (SafetySetting)
    }
  ],
  "generationConfig": {
    object (GenerationConfig)
  }
}
字段
contents[]

object (Content)

必需。与模型当前对话的内容。

对于单轮查询，这是一个实例。对于多轮查询，此字段为重复字段，其中包含会话历史记录 + 最新请求。
safetySettings[]

object (SafetySetting)

可选。用于屏蔽不安全内容的唯一 SafetySetting 实例列表。

此操作将对 GenerateContentRequest.contents 和 GenerateContentResponse.candidates 强制执行。每种 SafetyCategory 类型不应有多项设置。如果内容和响应未达到这些设置所设阈值，该 API 将屏蔽这些内容。此列表会覆盖 safetySettings 中指定的每个 SafetyCategory 的默认设置。如果列表中提供的给定 SafetyCategory 没有对应的 SafetySetting，API 将为该类别使用默认安全设置。支持 HARM_CATEGORY_HATE_SPEECH、HARM_CATEGORY_SEXUALLY_EXPLICIT、HARM_CATEGORY_DANGEROUS_CONTENT、HARM_CATEGORY_HARASSMENT 中的危害类别。
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

如需了解详情，请参阅身份验证概览。