文本生成与思考过程（流式）

使用 Vortap 调用 Gemini 2.5 Pro 的流式内容生成接口，可在模型逐步生成回答时持续接收增量结果。该接口适用于需要实时展示输出内容，或需要观察模型思考/推理相关返回信息的场景。

HTTP 请求

POST https://www.vortapapi.com/v1/v1beta/models/gemini-2.5-pro:streamGenerateContent

查询参数

参数名	类型	是否必填	说明
key	string	是	Vortap API Key，例如 sk-***。
alt	string	否	可选的响应格式控制参数。流式调用通常可使用与上游接口兼容的取值。

请求头

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

请求示例

curl -X POST "https://www.vortapapi.com/v1/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请用三句话解释大型语言模型的工作原理。"
          }
        ]
      }
    ]
  }'

多轮对话示例

curl -X POST "https://www.vortapapi.com/v1/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "我想学习 Python。"
          }
        ]
      },
      {
        "role": "model",
        "parts": [
          {
            "text": "很好！你可以从变量、条件语句、循环和函数开始。"
          }
        ]
      },
      {
        "role": "user",
        "parts": [
          {
            "text": "请给我一个适合初学者的练习。"
          }
        ]
      }
    ]
  }'

说明

• 该接口会以流式方式返回生成内容，客户端应按增量事件逐步读取响应。
• contents 用于传入对话上下文，数组中的每一项表示一轮消息。
• role 可用于区分用户输入与模型历史回复，例如 user 和 model。
• parts 用于承载具体内容，文本内容通常放在 text 字段中。