Gemini 3.1 Pro

请求 ID gemini-3.1-pro-preview

协议

POST /v1beta/models/gemini-3.1-pro-preview:generateContent · Gemini generateContent示例
POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent · Gemini streamGenerateContent示例

认证

请求需要 API Key。在控制台的 API Key 管理获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。

Gemini · x-goog-api-key: YOUR_API_KEY

请求参数

`POST /v1beta/models/gemini-3.1-pro-preview:generateContent`

参数	类型	是否必填	说明
`model (path)`	`string`	必填	URL 路径中的模型 ID，填写 `gemini-3.1-pro-preview`。
`contents`	`object[]`	必填	按顺序排列的会话内容。每项使用 `parts` 保存输入片段。
`contents[].role`	`string`	选填	消息角色。普通用户输入使用 `user`，模型历史消息使用 `model`。
`contents[].parts`	`object[]`	必填	内容项中的片段数组。文本片段使用 `text`。
`systemInstruction`	`object`	选填	系统指令对象。把指令文字放入 `parts[].text`。
`generationConfig.maxOutputTokens`	`integer`	选填	输出 token 的上限。可用上限因模型和接入点而异。
`generationConfig.temperature`	`number`	视条件	控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。
`generationConfig.topP`	`number`	视条件	按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
`generationConfig.responseMimeType`	`string`	选填	输出 MIME 类型。需要 JSON 时可填写 `application/json`。
`generationConfig.responseJsonSchema`	`object`	视条件	输出 JSON Schema，与 `responseMimeType: application/json` 搭配使用。以所选接入点支持的能力为准。

`POST /v1beta/models/gemini-3.1-pro-preview:streamGenerateContent`

参数	类型	是否必填	说明
`model (path)`	`string`	必填	URL 路径中的模型 ID，填写 `gemini-3.1-pro-preview`。
`contents`	`object[]`	必填	按顺序排列的会话内容。每项使用 `parts` 保存输入片段。
`contents[].role`	`string`	选填	消息角色。普通用户输入使用 `user`，模型历史消息使用 `model`。
`contents[].parts`	`object[]`	必填	内容项中的片段数组。文本片段使用 `text`。
`systemInstruction`	`object`	选填	系统指令对象。把指令文字放入 `parts[].text`。
`generationConfig.maxOutputTokens`	`integer`	选填	输出 token 的上限。可用上限因模型和接入点而异。
`generationConfig.temperature`	`number`	视条件	控制采样随机性。可用取值以及该字段是否生效，取决于模型和接入点。
`generationConfig.topP`	`number`	视条件	按累计概率限制采样候选。仅在所选模型和接入点支持时使用。
`generationConfig.responseMimeType`	`string`	选填	输出 MIME 类型。需要 JSON 时可填写 `application/json`。
`generationConfig.responseJsonSchema`	`object`	视条件	输出 JSON Schema，与 `responseMimeType: application/json` 搭配使用。以所选接入点支持的能力为准。
`?alt`	`string`	选填	查询参数。填 `sse` 以 SSE 接收 `streamGenerateContent` 的结果。

请求示例

先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。

Gemini generateContent

bash

curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:generateContent' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

Gemini streamGenerateContent

bash

curl -N -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?alt=sse' \
  -H "x-goog-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain how a rainbow forms in one sentence."
        }
      ]
    }
  ]
}'

读取响应

Gemini generateContent · 从 candidates[].content.parts[] 中读取文本片段。 JSON
Gemini streamGenerateContent · 逐条解析 SSE 数据，从 candidates[].content.parts[] 拼接文本。 SSE

完整接入指南