标准生成端点:POST /v1beta/models/{model}:generateContent流式生成端点:POST /v1beta/models/{model}:streamGenerateContent?alt=sse身份认证:Authorization: Bearer 您的API_KEY
路径参数
- :在 URL 路径中替换为模型 ID,例如
gemini-3.1-pro-preview。请以模型广场当前列表为准。
核心参数说明表
在发送请求时,请在请求体中提供以下参数:| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| contents | 必填 | 对话的内容部件(parts),包含文本或多模态数据的对象数组。 |
| generationConfig | 选填 | 生成参数配置对象,内部可设置温度 (temperature)、核采样 (topP) 以及最大输出长度 (maxOutputTokens)。 |
| systemInstruction | 选填 | 用于预设机器人人设的系统指令对象。 |
| safetySettings | 选填 | 安全审查设置等级控制。 |