Gemini 聊天接口（流式）

Endpoint： POST /v1beta/models/{model}:streamGenerateContent
Base URL： https://api.floxai.io
鉴权： x-goog-api-key: <your-api-key>

请求参数

Path 参数

参数	类型	必需	说明
`model`	string	是	模型名称，如 `gemini-2.5-flash`

Body 参数

基础输入

参数	类型	必需	说明
`contents`	array	是	对话内容数组，每项包含 `role`（`user` / `model`）和 `parts`（消息内容）
`system_instruction.parts`	object	否	系统指令，目前仅支持文本

生成设置（generationConfig）

参数	类型	说明
`temperature`	integer	采样温度
`topP`	number	核采样概率
`topK`	integer	Top-K 采样
`maxOutputTokens`	integer	最大输出 token 数
`stopSequences`	array[string]	停止序列
`responseMimeType`	string	结构化输出格式，如 `application/json`
`responseSchema`	object	输出 JSON Schema，须为 OpenAPI Schema 的子集
`responseModalities`	array[string]	输出模态：`Text` / `Image` / `AUDIO`
`speechConfig`	object	音频输出设置

推理设置（generationConfig.thinkingConfig）

参数	类型	说明
`includeThoughts`	boolean	是否在响应中包含推理过程
`thinkingBudget`	integer	推理最大 token 数

工具（tools）

参数	类型	说明
`tools[].functionDeclarations`	array	自定义函数工具
`tools[].codeExecution`	object	代码执行工具
`tools[].googleSearch`	object	联网搜索工具
`tool_config.functionCallingConfig`	object	函数调用配置

安全设置

参数	类型	说明
`safetySettings`	array	安全过滤配置，用于阻止不安全内容

请求示例

curl --location --request POST 'https://api.floxai.io/v1beta/models/gemini-2.5-flash:streamGenerateContent' \
  --header 'x-goog-api-key: <your-api-key>' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "contents": [
      {
        "parts": [
          {
            "text": "Write a story about a magic backpack."
          }
        ]
      }
    ]
  }'

Gemini Generate Content API Sdk Setup