Gemini 系列

gemini-3.5-flash

gemini-generate-content · /v1beta/models/{model}:generateContent

型号与端点

模型 ID：gemini-3.5-flash，请求中使用完整名称。

协议：gemini-generate-content。端点：POST /v1beta/models/gemini-3.5-flash:generateContent。

输入：text、image、audio、video、pdf。输出：text。

认证、完整字段和响应格式见 gemini-generate-content。调用前请确认 Key 已开通此型号。

请求示例

json

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "仅回复 READY"
        }
      ]
    }
  ],
  "generationConfig": {
    "maxOutputTokens": 8192
  }
}

以上为请求体示例，地址和请求头见协议页。其他可选字段请查阅对应参数说明。

参数与输入

图片、PDF、音频和视频各使用独立 inlineData part。thinkingConfig 的可用值按型号设置，3.7 / 3.8 Flash 不支持 minimal。多轮消息需保留 thoughtSignature。本版支持范围不包含 Files API、原生工具结果回传和强制 JSON Schema。

推理字段 generationConfig.thinkingConfig.thinkingLevel 支持：low、medium、high。省略时使用默认设置，输出预算另行配置。原厂字段说明与型号参数。

附件格式：PNG/JPEG/WebP; PDF; WAV/MP3; MP4/MPEG/MOV/AVI/MPG/WMV。编码：contents[].parts[].inlineData: mimeType + Base64。

官方限制：视频 inline 原厂 <100 MB；PDF 原厂 <=1000 页。

上传说明：未公布统一文件大小、时长或页数上限，大小按编码后的完整 JSON 体计算。其他限制：不支持 Files API、其他音视频格式、原生工具结果回传或强制 JSON Schema。完整规格见模型输入规格表。

响应处理

检查 candidates 的 finishReason 和内容。MAX_TOKENS 表示截断，受限结束或空候选需另行处理。文件大小及格式要求见文件与媒体输入。