Gemini 3.8 Flash

请求 ID gemini-3.8-flash

协议

POST /v1beta/models/gemini-3.8-flash:generateContent · Gemini generateContent示例
POST /v1beta/models/gemini-3.8-flash: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.8-flash:generateContent`

参数	类型	是否必填	说明
`model (path)`	`string`	必填	URL 路径中的模型 ID，填写 `gemini-3.8-flash`。
`contents`	`object[]`	必填	按顺序排列的会话内容。每项使用 `parts` 保存输入片段。
`contents[].role`	`string`	选填	消息角色。普通用户输入使用 `user`，模型历史消息使用 `model`。
`contents[].parts`	`object[]`	必填	内容项中的片段数组。文本片段使用 `text`。
`contents[].parts[].inlineData`	`object`	视条件	内联媒体对象。使用 `mimeType` 和 Base64 编码的 `data`。可用媒体类型取决于模型和接入点。
`systemInstruction`	`object`	选填	系统指令对象。把指令文字放入 `parts[].text`。
`generationConfig.maxOutputTokens`	`integer`	选填	输出 token 的上限。可用上限因模型和接入点而异。
`generationConfig.responseMimeType`	`string`	选填	输出 MIME 类型。需要 JSON 时可填写 `application/json`。
`generationConfig.responseJsonSchema`	`object`	视条件	输出 JSON Schema，与 `responseMimeType: application/json` 搭配使用。以所选接入点支持的能力为准。
`tools`	`object[]`	视条件	供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。

`POST /v1beta/models/gemini-3.8-flash:streamGenerateContent`

参数	类型	是否必填	说明
`model (path)`	`string`	必填	URL 路径中的模型 ID，填写 `gemini-3.8-flash`。
`contents`	`object[]`	必填	按顺序排列的会话内容。每项使用 `parts` 保存输入片段。
`contents[].role`	`string`	选填	消息角色。普通用户输入使用 `user`，模型历史消息使用 `model`。
`contents[].parts`	`object[]`	必填	内容项中的片段数组。文本片段使用 `text`。
`contents[].parts[].inlineData`	`object`	视条件	内联媒体对象。使用 `mimeType` 和 Base64 编码的 `data`。可用媒体类型取决于模型和接入点。
`systemInstruction`	`object`	选填	系统指令对象。把指令文字放入 `parts[].text`。
`generationConfig.maxOutputTokens`	`integer`	选填	输出 token 的上限。可用上限因模型和接入点而异。
`generationConfig.responseMimeType`	`string`	选填	输出 MIME 类型。需要 JSON 时可填写 `application/json`。
`generationConfig.responseJsonSchema`	`object`	视条件	输出 JSON Schema，与 `responseMimeType: application/json` 搭配使用。以所选接入点支持的能力为准。
`tools`	`object[]`	视条件	供模型调用的工具定义。工具类型与参数格式以所选协议和接入点支持的能力为准。
`?alt`	`string`	选填	查询参数。填 `sse` 以 SSE 接收 `streamGenerateContent` 的结果。

请求示例

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

Gemini generateContent

bash

curl -sS 'https://api.icodeeasy.cc/v1beta/models/gemini-3.8-flash: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.8-flash: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

完整接入指南

能力与限制

streaming · 支持
tool_calling · 有条件支持 — 取决于兼容的协议与请求格式
image_input · 有条件支持 — 取决于兼容的接入点与请求格式
video_input · 有条件支持 — 取决于兼容的接入点与请求格式

兼容别名与退役重定向

gemini-3.7-flash, gemini-3.6-flash, gemini-3.5-flash, gemini-3-flash, gemini-3-flash-preview, gemini-3.1-flash-lite, gemini-3.1-flash-lite-preview → gemini-3.8-flash (退役重定向)

模型能力目录 · 查看定价