Gemini generateContent
Gemini generateContent 使用 Gemini 官方请求结构，适合已经围绕 Google AI/Gemini SDK 构建的文本应用。Endpoint
POST /v1beta/models/{model}:generateContent
鉴权
x-goog-api-key: <YOUR_API_KEY>，也可使用 ?key= 查询参数。
参数说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 路径参数，Gemini 模型名称。 |
contents | array | 是 | 内容数组，元素包含 role 与 parts。 |
contents[].role | string | 否 | 通常为 user 或 model。 |
contents[].parts | array | 是 | 分段内容，如文本、媒体或函数相关内容。 |
contents[].parts[].text | string | 否 | 文本内容。 |
generationConfig | object | 否 | 生成参数配置。 |
generationConfig.temperature | number | 否 | 采样温度。 |
generationConfig.topP | number | 否 | nucleus sampling 参数。 |
generationConfig.maxOutputTokens | integer | 否 | 最大输出 token 数。 |
safetySettings | array | 否 | 安全策略设置。 |
systemInstruction | object | 否 | 系统指令。 |
响应说明
| 字段 | 类型 | 说明 |
|---|---|---|
candidates[] | array | 候选响应。 |
candidates[].content.parts[].text | string | 输出文本。 |
candidates[].finishReason | string | 生成结束原因。 |
usageMetadata | object | token 用量统计。 |