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 用量统计。

API Reference

查看底层接口定义