支持的模型

模型	说明	audio 有声能力
wan2.6‑r2v	标准参考生视频，支持图片 / 视频参考，单 / 多角色表演互动	不支持 audio 参数，固定有声
wan2.6‑r2v‑flash	快速版参考生视频，成本更低，适合批量测试角色	支持audio参数，可开启 / 关闭音频

调用流程

接口采用异步任务模式，分两步执行：

step1：调用创建任务接口，成功返回task_id

step2：调用查询任务接口查询对应task_id，直到task_status值为SUCCEEDED，获取生成视频url

创建任务接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis

请求头

参数	必填	说明
Content‑Type	是	固定application/json
Authorization	是	Bearer ${YOUR_APP_KEY}
X‑DashScope‑Async	是	必须enable

请求参数

字段	类型	必选	说明
model	string	是	模型调用名称或模型ID
input	object	是	输入的基本信息，如提示词等。
input.prompt	string	否	正向提示词
input.negative_prompt	string	否	反向提示词
input.reference_urls	array[string]	是	上传的参考文件 URL 数组，支持传入视频和图像。用于提取角色形象与音色（如有），以生成符合参考特征的视频。 - 每个 URL 可指向一张图像或一段视频： - 图像数量：0～5。 - 视频数量：0～3。 - 总数限制：图像 + 视频 ≤ 5。 - 传入多个参考文件时，按照数组顺序定义角色的顺序。即第 1 个 URL 对应 character1，第 2 个对应 character2，以此类推。 - 每个参考文件仅包含一个主体角色。例如 character1 为小女孩，character2 为闹钟。参考视频要求： - 格式：MP4、MOV。 - 时长：1s～30s。 - 视频大小：不超过100MB。参考图像要求： - 格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP。 - 分辨率：宽高均需在[240,8000]像素之间。 - 图像大小：不超过20MB。
parameters	object	否	视频处理参数，如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。
parameters.size	string	否	分辨率档位此参数的默认值和可用枚举值依赖于 model 参数，规则如下： - wan2.6-r2v-flash：默认值为 19201080（1080P）。可选分辨率：720P、1080P对应的所有分辨率。 - wan2.6-r2v：默认值为 19201080（1080P）。可选分辨率：720P、1080P对应的所有分辨率。 720P档位：可选的视频分辨率及其对应的视频宽高比为： - 1280720：16:9。 - 7201280：9:16。 - 960960：1:1。 - 1088832：4:3。 - 8321088：3:4。 1080P档位：可选的视频分辨率及其对应的视频宽高比为： - 19201080： 16:9。 - 10801920： 9:16。 - 14401440： 1:1。 - 16321248： 4:3。 - 12481632： 3:4。
parameters.duration	int	否	视频时长；该参数的取值依赖于 model参数： - wan2.6-r2v-flash：取值为[2, 10]之间的整数。默认值为5。 - wan2.6-r2v：取值为[2, 10]之间的整数。默认值为5。
parameters.shot_type	string	否	指定生成视频的镜头类型，即视频是由一个连续镜头还是多个切换镜头组成。参数优先级：shot_type > prompt。例如，若 shot_type设置为"single"，即使 prompt 中包含“生成多镜头视频”，模型仍会输出单镜头视频。可选值： - single：默认值，输出单镜头视频 - multi：输出多镜头视频。
parameters.audio	bool	否	支持模型：wan2.6-r2v-flash。是否生成有声视频。可选值： - true：默认值，输出有声视频。 - false：输出无声视频。示例值：true。
parameters.watermark	bool	否	是否添加水印标识，水印位于视频右下角，文案固定为“AI生成”。 - false：默认值，不添加水印。 - true：添加水印。
parameters.seed	int	否	随机种子 [0,2147483647]；相同 seed 结果倾向稳定，但不能保证完全一致

响应参数

参数	类型	说明
request_id	string	请求唯一标识，用于问题排查溯源
output	object	任务输出主体
output.task_id	string	查询的任务 ID
output.task_status	string	任务状态 - PENDING：任务排队中 - RUNNING：任务处理中 - SUCCEEDED：任务执行成功 - FAILED：任务执行失败 - CANCELED：任务已取消 - UNKNOWN：任务不存在或状态未知

查询任务接口详情

http调用

请求方式：GET

请求路径：https://ai.ctaigw.cn/v1/tasks/{task_id}

Path 路径参数

参数	类型	必填	说明
task_id	string	是	创建异步任务接口返回的任务 ID

请求头

参数	类型	必填	说明
Authorization	string	是	身份认证，格式：Bearer ${YOUR_APP_KEY}

响应参数

参数	类型	说明
request_id	string	请求唯一标识，用于问题排查溯源
output	object	任务输出主体
output.task_id	string	查询的任务 ID
output.task_status	string	任务状态 - PENDING：任务排队中 - RUNNING：任务处理中 - SUCCEEDED：任务执行成功 - FAILED：任务执行失败 - CANCELED：任务已取消 - UNKNOWN：任务不存在或状态未知
output.submit_time	string	任务提交时间，格式YYYY‑MM‑DD HH:mm:ss.SSS
output.scheduled_time	string	任务调度执行时间
output.end_time	string	任务结束时间；任务未结束为空
output.video_url	string	视频URL。仅在 task_status 为 SUCCEEDED 时返回
output.orig_prompt	string	原始输入的prompt，对应请求参数prompt
usage	object	用量统计，仅任务成功返回
usage.input_video_duration	integer	输入的视频的时长，单位秒
usage.output_video_duration	integer	输出视频的时长，单位秒其值等同于 input.duration 的入参值。
usage.duration	integer	总的视频时长，用于计费。等于 input_video_duration +output_video_duration。
usage.SR	integer	生成视频的分辨率档位。示例值：720。
usage.video_count	integer	生成视频的数量。固定为 1。
usage.size	string	生成视频的分辨率。格式为“宽高”

请求/响应示例

创建任务示例

请求示例

curl --location 'https://ai.ctaigw.cn/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer ${YOUR_APP_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.6-r2v-flash",
    "input": {
        "prompt": "character1在沙发上开心地看电影",
        "reference_urls": [
            "https://aaaa.ctyun.cn/video/01.mp4",
            
        ]
    },
    "parameters": {
        "size": "1280*720",
        "duration": 10,
        "audio": true,
        "shot_type": "multi",
        "watermark": true
    }
}'

正常响应

{
    "output": {
        "task_status": "PENDING",
        "task_id": "xxxx‑xxxx‑xxxx‑xxxx"
    },
    "request_id": "00d06a841873c0a83bfaf1fae0184625"
}

异常响应示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}

查询任务请求示例

请求

curl -X GET https://ai.ctaigw.cn/v1/tasks/{task_id} \
--header "Authorization: Bearer ${YOUR_APP_KEY}"

正常响应示例

{
   "request_id": "00d06a841873c0a83bfaf1fae0184625",
    "output": {
        "task_id": "xxxx‑xxxx‑xxxx‑xxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2026-08-26 12:10:05.001",
        "scheduled_time": "2026-08-26 12:10:05.201",
        "end_time": "2026-08-26 12:10:25.001",
        "orig_prompt": "character1在沙发上开心地看电影",
        "video_url": "https://aaaa.ctyun.cn/xxx.mp4"
    },
    "usage": {
        "duration": 10,
        "input_video_duration": 5,
        "output_video_duration": 5,
        "video_count": 1,
        "SR": 720
    }
}

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

支持的模型

调用流程

创建任务接口详情

http调用

请求头

请求参数

响应参数

查询任务接口详情

http调用

Path 路径参数

请求头

响应参数

请求/响应示例

创建任务示例

请求示例

正常响应

异常响应示例

查询任务请求示例

请求

正常响应示例

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

支持的模型

调用流程

创建任务接口详情

http调用

请求头

请求参数

响应参数

查询任务接口详情

http调用

Path 路径参数

请求头

响应参数

请求/响应示例

创建任务示例

请求示例

正常响应

异常响应示例

查询任务请求示例

请求

正常响应示例