Generate Content

调用 Gemini 模型生成内容

POST/gemini/v1beta/models/{model}:generateContent

认证:x-goog-api-keyHeader

路径参数

参数	类型	必填	说明
model	string	是	模型名称，如 `google/gemini-3.1-flash-lite-preview`

请求参数

参数	类型	必填	说明
contents	array	是	内容数组，定义对话历史
generationConfig	object	否	生成配置，控制输出格式、温度等
safetySettings	array	否	安全设置，过滤有害内容
systemInstruction	object	否	系统指令，设置模型行为

Contents 格式说明

role 角色

user - 用户消息
model - 模型回复

parts 内容格式

每个 part 可以是纯文本或包含多模态内容：

// 纯文本
{"parts": [{"text": "你好，请介绍一下自己"}]}

// 多模态 (含图片)
{
  "parts": [
    {"text": "这张图片里有什么？"},
    {"inlineData": {
      "mimeType": "image/png",
      "data": "base64编码的图片数据"
    }}
  ]
}

请求示例

curl "https://api.mintcloud.ai/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview:generateContent" \
  -H "x-goog-api-key: $MINTCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello!"}]}]
  }'

流式响应

使用 Server-Sent Events (SSE) 获取流式响应：

POST/gemini/v1beta/models/{model}:generateContent?alt=sse

curl "https://api.mintcloud.ai/gemini/v1beta/models/google/gemini-3.1-flash-lite-preview:generateContent?alt=sse" \
  -H "x-goog-api-key: $MINTCLOUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "讲一个故事"}]}]
  }'

支持的模型

gemini-3.1-flash-lite-previewgemini-3.1-flashgemini-3.1-progemini-3.0-flashgemini-2.0-flashgemini-2.0-flash-exp