streamGenerateContent - Vertex AI 流式生成内容

更新时间：2026-06-13 12:16:27

功能说明

此接口提供与 Google Vertex AI 兼容的流式内容生成功能。适用于需要实时、持续获取AI生成内容（如文本、代码）的场景。调用此接口将启动一个流式响应，持续返回生成的内容片段。

调用说明

接口约束

调用者需要拥有 API Key，详情请参见管理 AI API Key。

请求路径

POST {BASE_URL}/api/vertex-ai/v1/publishers/{provider}/models/{model}:streamGenerateContent

注意：相同处理器也挂载在 /api/v1 与 /api/vertex-ai/v1beta 路径下，并支持 /models/{provider}/{model}:streamGenerateContent 别名。

请求头

名称	是否必选	示例值	描述
Authorization	是	Bearer {token}	鉴权信息
Content-Type	否	application/json	请求体格式

请求参数

Path 参数

名称	类型	是否必填	示例值	描述
provider	string	是	google	模型发布者
model	string	是	gemini-pro	模型名称

Body 参数

名称	类型	是否必填	示例值	描述
model	string	是	gemini-pro	指定使用的模型
contents	array[object]	否	[{"role": "user", "parts": [{"text": "Hello"}]}]	对话内容列表
instances	array[object]	否	[]	实例列表
parameters	object	否	{"temperature": 0.7}	生成参数
voice	object	否	{}	语音参数

返回结果

返回参数

名称	类型	描述
success	boolean	请求是否成功
code	string	返回码
message	string	返回信息
data	object	业务返回数据

data 字段说明

名称	类型	描述
id	string	资源唯一 ID
name	string	资源名称
status	string	资源状态
createTime	string	创建时间

请求示例

curl --request POST '{BASE_URL}/api/vertex-ai/v1/publishers/google/models/gemini-pro:streamGenerateContent' \
  --header 'Authorization: Bearer {token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gemini-pro",
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请介绍一下人工智能。"
          }
        ]
      }
    ],
    "parameters": {
      "temperature": 0.7,
      "maxOutputTokens": 256
    }
  }'

返回示例

{
  "success": true,
  "code": "200",
  "message": "successful",
  "data": {
    "id": "gen-123456",
    "name": "stream-generation-task",
    "status": "STREAMING",
    "createTime": "2026-04-10T10:00:00Z"
  }
}