文本生成（流式）

使用流式接口让模型在生成过程中持续返回增量内容，适合聊天、长文本生成、实时输出展示等场景。

POST https://www.vortapapi.com/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent

接口说明

该接口会以流式方式生成文本内容。客户端提交对话内容后，Vortap 会在模型生成过程中分批返回结果，而不是等待完整响应生成完毕后一次性返回。

查询参数

名称	类型	必填	说明
key	string	是	API Key。示例：sk-***
alt	string	否	响应格式控制参数。流式调用通常可使用 sse 获取 Server-Sent Events 格式响应。

请求头

名称	必填	说明
Content-Type	是	请求体格式，通常为 application/json。

请求体示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "请用三句话介绍量子计算。"
        }
      ]
    }
  ]
}

cURL 示例

curl -N "https://www.vortapapi.com/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent?key=sk-***&alt=sse" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请用三句话介绍量子计算。"
          }
        ]
      }
    ]
  }'

多轮对话示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "什么是机器学习？"
        }
      ]
    },
    {
      "role": "model",
      "parts": [
        {
          "text": "机器学习是一种让计算机从数据中学习规律并进行预测或决策的方法。"
        }
      ]
    },
    {
      "role": "user",
      "parts": [
        {
          "text": "请给我一个生活中的例子。"
        }
      ]
    }
  ]
}

响应

启用流式输出后，服务端会持续推送生成结果。客户端应按流式数据块逐步读取并处理内容。

当使用 alt=sse 时，响应通常以 SSE 事件流形式返回。

示例片段：

data: {"candidates":[{"content":{"parts":[{"text":"量子"}],"role":"model"}}]}

data: {"candidates":[{"content":{"parts":[{"text":"计算利用"}],"role":"model"}}]}

data: {"candidates":[{"content":{"parts":[{"text":"量子力学原理进行信息处理。"}],"role":"model"}}]}

注意事项

• key 是必填查询参数，请勿在客户端代码或公开仓库中暴露真实密钥。
• 流式接口需要客户端支持持续读取响应体。
• 如果希望使用 SSE 格式处理流式数据，可在查询参数中添加 alt=sse。
• 请求体中的 contents 用于描述当前输入或对话上下文，多轮对话应按历史顺序传入。