Gemini Generate Content

使用 Gemini Content 与 Parts 结构创建文本、多模态、工具和代码执行响应。

Generate Content 接口使用 Content 与 Parts 表达文本、多模态、函数调用和代码执行请求，并通过 Candidates、Usage Metadata 与安全信息返回生成结果。请求使用 Bearer API Key 鉴权；不同模型支持的输入模态、工具和高级生成参数可能不同，请以当前账户可见模型及官方能力说明为准。

POST/v1beta/models/{model}:generateContent

使用 Gemini Content 与 Parts 结构生成文本、多模态、函数调用或代码执行响应。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Path Parameters

model*string

用于生成内容的模型 ID。路径中会自动组成 models/{model}。

Default"MODEL_ID"

Request Body

Gemini 使用 Content 与 Parts 表达文本、多模态、工具和生成配置。

application/json

文本对话

使用 user 与 model Content 组织单轮或多轮文本对话。

contents[]: 按顺序排列的对话内容。
parts[].text: 每条消息中的文本内容。
role: 消息生产者，常用值为 user 或 model。

application/json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "你好！请介绍一下自己。"
        }
      ]
    }
  ]
}

使用 Content 与 text Part 组织单轮或多轮文本对话。

contents*array<>

按顺序排列的文本 Content。每条消息通过 parts[].text 提供内容。

Items1 <= items

tools?array<>

模型可以使用的函数、代码执行、搜索、URL Context、File Search、MCP 等工具。

toolConfig?

请求中工具的调用配置。

safetySettings?array<>

按安全类别配置内容屏蔽阈值。

systemInstruction?

开发者设置的系统指令，当前仅支持文本内容。

generationConfig?

模型生成和输出配置。

cachedContent?string

作为上下文使用的缓存内容名称，格式为 cachedContents/{cachedContent}。

serviceTier?ServiceTier

请求使用的服务层级。

Value in

"unspecified"
"standard"
"flex"
"priority"

store?boolean

控制当前请求的日志记录行为；设置后优先于项目级日志配置。

Response Body

`application/json`

curl -X POST "https://example.com/v1beta/models/MODEL_ID:generateContent" \  -H "Content-Type: application/json" \  -d '{    "contents": [      {        "role": "user",        "parts": [          {            "text": "你好！请介绍一下自己。"          }        ]      }    ]  }'

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "你好！我是一个 AI 助手，可以帮助你解答问题和完成任务。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 24
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_HARASSMENT",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 24,
    "totalTokenCount": 32,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 8
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 24
      }
    ]
  },
  "modelVersion": "MODEL_ID",
  "responseId": "response-example"
}

Google Gemini Generate Content 官方文档查看上游协议定义与最新字段变化。

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

413application/json

429application/json

500application/json

503application/json

504application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`