Vidu2.0
vidu/vidu2.0
异步任务:POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果(POST 发送后 request_id 自动填入 GET)。
https://router.shengsuanyun.com/apiAuthorization: Bearer YOUR_API_KEY端点列表
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" |
resolution | string | 可选值:"360p" · "720p" |
duration | integer | 可选值:4 |
movement_amplitude | string | 可选值:"auto" · "small" · "medium" · "large" |
bgm | boolean | |
payload | string | |
seed | integer | |
images必填 | array | 展开结构
数组元素
|
model必填 | string | 路由模型,本页固定为 vidu/vidu2.0 |
anyOf · 2
| 字段 | 类型 | 说明 |
|---|---|---|
prompt | stringtextarea | |
style | string | 可选值:"general" · "anime" |
aspect_ratio | string | 可选值:"16:9" |
resolution | string | 可选值:"360p" · "720p" |
duration | integer | 可选值:4 |
movement_amplitude | string | 可选值:"auto" · "small" · "medium" · "large" |
bgm | boolean | |
payload | string | |
seed | integer | |
images必填 | array | 展开结构
数组元素
|
reference必填 | boolean | |
model必填 | string | 路由模型,本页固定为 vidu/vidu2.0 |
anyOf · 3
| 字段 | 类型 | 说明 |
|---|---|---|
prompt | stringtextarea | |
style | string | 可选值:"general" · "anime" |
aspect_ratio | string | 可选值:"16:9" |
resolution | string | 可选值:"360p" · "720p" |
duration | integer | 可选值:4 |
movement_amplitude | string | 可选值:"auto" · "small" · "medium" · "large" |
bgm | boolean | |
payload | string | |
seed | integer | |
images必填 | array | 展开结构
数组元素
|
model必填 | string | 路由模型,本页固定为 vidu/vidu2.0 |
{
"aspect_ratio": "16:9",
"bgm": false,
"duration": 4,
"images": [
"https://oss.shengsuanyun.com/example/modelinfo/131/2025-09-23_15:36:03_input_1.png"
],
"model": "vidu/vidu2.0",
"movement_amplitude": "medium",
"prompt": "电影级魔幻场景,镜头从高空缓缓俯拍后缓慢推近——身着复古花裙的爱丽丝静坐在苔藓覆盖的奇幻森林里,发光的珍珠气球悬浮着轻晃,巨型花朵的花瓣如呼吸般微颤,散落的卡牌边缘泛着幽蓝荧光;爱丽丝的裙摆随林间细风轻轻起伏,苔藓石坛旁的陶罐阴影中,飘出萤火虫似的暖黄光点,整体画面在暗调逆光中晕着柔焦,营造出梦游仙境的迷幻氛围。",
"resolution": "720p",
"seed": -1,
"style": "anime"
}请求示例
参考地址: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": 4,
"images": [
"https://oss.shengsuanyun.com/example/modelinfo/131/2025-09-23_15:36:03_input_1.png"
],
"model": "vidu/vidu2.0",
"movement_amplitude": "medium",
"prompt": "电影级魔幻场景,镜头从高空缓缓俯拍后缓慢推近——身着复古花裙的爱丽丝静坐在苔藓覆盖的奇幻森林里,发光的珍珠气球悬浮着轻晃,巨型花朵的花瓣如呼吸般微颤,散落的卡牌边缘泛着幽蓝荧光;爱丽丝的裙摆随林间细风轻轻起伏,苔藓石坛旁的陶罐阴影中,飘出萤火虫似的暖黄光点,整体画面在暗调逆光中晕着柔焦,营造出梦游仙境的迷幻氛围。",
"resolution": "720p",
"seed": -1,
"style": "anime"
}'响应
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
未提供结构定义。
{
"progress": 100,
"video_urls": [
"https://oss.shengsuanyun.com/example/modelinfo/131/2025-09-23_15:36:03_output_2.mp4"
]
}