原站参考文档

以下为胜算云公开资料。文中的原站账号、地址、定价和专有服务不属于蓝天；蓝天可用模型以当前 sub2api 配置为准。接入蓝天请先查看快速开始。

ViduQ3-Pro

vidu/viduq3-pro
异步任务：POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果（POST 发送后 request_id 自动填入 GET）。

BASE URLhttps://router.shengsuanyun.com/api

认证方式Authorization: Bearer YOUR_API_KEY

端点列表

← 上一页

Vidu 视频系列 · 接口汇总

ViduQ2-turbo

接口参考

以下为原文协议定义与示例，原站地址不代表蓝天已开通对应能力。蓝天接入地址和模型以本地配置为准。

蓝天 API 密钥

POST/v1/tasks/generationsVidu 视频生成-异步

异步任务：POST 提交后返回 request_id，再用 GET /v1/tasks/generations/{request_id} 轮询结果。

请求体

application/json

object

anyOf · 1

字段	类型	说明
`prompt`必填	stringtextarea
`style`	string	可选值："general" · "anime"
`aspect_ratio`	string	可选值："16:9" · "9:16" · "1:1"
`resolution`	string	可选值："1080p"
`duration`	integer	可选值：5
`movement_amplitude`	string	可选值："auto" · "small" · "medium" · "large"
`bgm`	boolean
`payload`	string
`seed`	integer
`model`必填	string	路由模型，本页固定为 vidu/viduq3-pro

anyOf · 2

字段	类型	说明
`prompt`	stringtextarea
`style`	string	可选值："general" · "anime"
`aspect_ratio`	string	可选值："16:9"
`resolution`	string	可选值："1080p"
`duration`	integer	可选值：5
`movement_amplitude`	string	可选值："auto" · "small" · "medium" · "large"
`bgm`	boolean
`payload`	string
`seed`	integer
`images`必填	array	展开结构 `array` 数组元素 `string`
`model`必填	string	路由模型，本页固定为 vidu/viduq3-pro

anyOf · 3

字段	类型	说明
`prompt`	stringtextarea
`style`	string	可选值："general" · "anime"
`aspect_ratio`	string	可选值："16:9"
`resolution`	string	可选值："1080p"
`duration`	integer	可选值：5
`movement_amplitude`	string	可选值："auto" · "small" · "medium" · "large"
`bgm`	boolean
`payload`	string
`seed`	integer
`images`必填	array	展开结构 `array` 数组元素 `string`
`reference`必填	boolean
`model`必填	string	路由模型，本页固定为 vidu/viduq3-pro

anyOf · 4

字段	类型	说明
`prompt`	stringtextarea
`style`	string	可选值："general" · "anime"
`aspect_ratio`	string	可选值："16:9"
`resolution`	string	可选值："1080p"
`duration`	integer	可选值：5
`movement_amplitude`	string	可选值："auto" · "small" · "medium" · "large"
`bgm`	boolean
`payload`	string
`seed`	integer
`images`必填	array	展开结构 `array` 数组元素 `string`
`model`必填	string	路由模型，本页固定为 vidu/viduq3-pro

{
  "aspect_ratio": "16:9",
  "bgm": false,
  "duration": 5,
  "model": "vidu/viduq3-pro",
  "movement_amplitude": "auto",
  "prompt": "Extend the video. The camera tracks a man in orange riding a brown horse. He accelerates toward a large tree blooming with orange flowers ahead. He reaches up and plucks two flowers from a branch. Soon, other riders on horseback enter the frame one after another. The camera pushes in as the man in orange swiftly dismounts. The camera rapidly circles around him. He turns and walks toward a woman in white riding a white horse, presenting the flowers to her. Style: classical Chinese \"court lady painting\" aesthetic. Music: cheerful traditional Chinese folk instrumental.",
  "resolution": "1080p",
  "seed": -1,
  "style": "general"
}

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X POST 'https://router.shengsuanyun.com/api/v1/tasks/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "aspect_ratio": "16:9",
  "bgm": false,
  "duration": 5,
  "model": "vidu/viduq3-pro",
  "movement_amplitude": "auto",
  "prompt": "Extend the video. The camera tracks a man in orange riding a brown horse. He accelerates toward a large tree blooming with orange flowers ahead. He reaches up and plucks two flowers from a branch. Soon, other riders on horseback enter the frame one after another. The camera pushes in as the man in orange swiftly dismounts. The camera rapidly circles around him. He turns and walks toward a woman in white riding a white horse, presenting the flowers to her. Style: classical Chinese \"court lady painting\" aesthetic. Music: cheerful traditional Chinese folk instrumental.",
  "resolution": "1080p",
  "seed": -1,
  "style": "general"
}'

响应

200 提交成功，返回 request_id / task_id

application/json

未提供结构定义。

{
  "code": "success",
  "message": "",
  "data": {
    "request_id": "REQ_xxx",
    "task_id": "TASK_xxx",
    "action": "GENERATION",
    "status": "PENDING",
    "progress": "0%"
  }
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误

GET/v1/tasks/generations/{request_id}查询异步任务状态与产物

通过 POST /v1/tasks/generations 返回的 request_id 轮询任务状态、进度与产物 URL（image_urls / video_urls / audio_urls / file_urls / text）。下方「在线测试」填入 request_id 即可发送查询；若上方 POST 已发送成功，request_id 会自动填入。

请求参数

参数	位置 / 类型	说明
`request_id`必填	path / string	POST /v1/tasks/generations 返回的请求 ID

请求示例

参考地址：https://router.shengsuanyun.com/api。路径参数与凭据需替换；非 JSON 请求体需按对应格式准备。

curl -X GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}' \
  -H 'Authorization: Bearer YOUR_API_KEY'

响应

200 任务状态与产物

application/json

未提供结构定义。

{
  "image_urls": [
    "https://shengsuanyun.oss-cn-shanghai.aliyuncs.com/example/modelinfo/282/2026-02-27_output_1.mp4"
  ],
  "progress": 100
}

400 请求参数错误

401 未授权（API Key 无效）

429 请求过于频繁

500 服务器内部错误