支持的模型

模型名称	任务类型	核心能力	时长规则	分辨率可选	音频支持
wan2.2‑i2v‑flash	首帧生视频	基础图生视频，速度快，无声	固定 5s 不可修改	480P、720P、1080P，默认 720P	否
wan2.2‑i2v‑plus	首帧生视频	画面细节更好，无声	固定 5s 不可修改	480P、1080P，默认 1080P	否
wan2.5‑i2v‑preview	首帧生视频	支持音频，自动配音、自定义音频	5s/10s，默认 5s	480P、720P、1080P，默认 1080P	是
wan2.6‑i2v	首帧生视频	支持音频、多镜头叙事，时长灵活	2‑15s 整数，默认 5s	720P、1080P，默认 1080P	是
wan2.6‑i2v‑flash	首帧生视频	高性能快速版本，有声 / 无声切换、多镜头	2‑15s 整数，默认 5s	720P、1080P，默认 1080P	是
wan2.2‑kf2v‑flash	首尾帧生视频	输入首帧 + 尾帧，生成平滑过渡视频	固定 5s 不可修改	480P、720P、1080P，默认 720P	否

调用流程

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

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

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

接口详情

首帧生视频创建接口详情

模型：wan2.2‑i2v‑flash、wan2.2‑i2v‑plus、wan2.5‑i2v‑preview、wan2.6‑i2v、wan2.6‑i2v‑flash

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.img_url	string	是	首帧图像的URL或 Base64 编码数据
input.audio_url	string	否	支持模型：wan2.6和wan2.5系列模型。音频文件的 URL，模型将使用该音频生成视频。
input.template	string	否	视频特效模板的名称
parameters	object	否	视频处理参数，如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。
parameters.resolution	string	否	分辨率档位此参数的默认值和可用枚举值依赖于 model 参数，规则如下： - wan2.6-i2v-flash：可选值：720P、1080P。默认值为1080P。 - wan2.6-i2v ：可选值：720P、1080P。默认值为1080P。 - wan2.5-i2v-preview ：可选值：480P、720P、1080P。默认值为1080P。 - wan2.2-i2v-flash：可选值：480P、720P、1080P。默认值为720P。 - wan2.2-i2v-plus：可选值：480P、1080P。默认值为1080P。
parameters.duration	int	否	视频时长；该参数的取值依赖于 model参数： - wan2.6-i2v-flash：取值为[2, 15]之间的整数。默认值为5。 - wan2.6-i2v：取值为[2, 15]之间的整数。默认值为5。 - wan2.5-i2v-preview：可选值为5、10。默认值为5。 - wan2.2-i2v-plus：固定为5秒，且不支持修改。 - wan2.2-i2v-flash：固定为5秒，且不支持修改。
parameters.prompt_extend	bool	否	是否开启 prompt 智能改写
parameters.shot_type	string	否	指定生成视频的镜头类型，即视频是由一个连续镜头还是多个切换镜头组成。仅 wan2.6系列支持；生效条件：仅当"prompt_extend": true 时生效。参数优先级：shot_type > prompt。例如，若 shot_type设置为"single"，即使 prompt 中包含“生成多镜头视频”，模型仍会输出单镜头视频。可选值： - single：默认值，输出单镜头视频 - multi：输出多镜头视频。
parameters.audio	bool	否	是否生成有声视频。参数优先级：audio > audio_url。当 audio=false时，即使传入 audio_url，输出仍为无声视频，且计费按无声视频计算。可选值： - true：默认值，输出有声视频。 - false：输出无声视频。
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：任务不存在或状态未知

首帧生视频查询任务接口详情

模型：wan2.2‑i2v‑flash、wan2.2‑i2v‑plus、wan2.5‑i2v‑preview、wan2.6‑i2v、wan2.6‑i2v‑flash

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
output.actual_prompt	string	当 prompt_extend=true 时，系统会对输入 prompt 进行智能改写，此字段返回实际用于生成的优化后 prompt。 - 若 prompt_extend=false，该字段不会返回。 - 注意：wan2.6 模型无论 prompt_extend 取值如何，均不返回此字段。
usage	object	用量统计，仅任务成功返回不同模型不同，详见如下

wan2.6系列模型返回的usage里的参数

参数	类型	说明
input_video_duration	integer	输入的视频的时长，单位秒
output_video_duration	integer	输出视频的时长，单位秒其值等同于 input.duration 的入参值。
duration	integer	总的视频时长，用于计费。等于 input_video_duration +output_video_duration。
SR	integer	生成视频的分辨率档位。示例值：720。
video_count	integer	生成视频的数量。固定为 1。
audio	boolean	表示输出视频是否为有声视频。

wan2.2和wan2.5系列模型返回的usage里的参数

参数	类型	说明
duration	integer	生成视频的时长，单位为秒
SR	integer	生成视频的分辨率。枚举值为 480、720、1080。
video_count	integer	生成视频的数量。固定为 1。

首尾帧生视频创建接口详情

模型：wan2.2‑kf2v‑flash

http调用

请求方式：POST

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

请求头

参数	必填	说明
Content‑Type	是	固定application/json
Authorization	是	Bearer sk‑xxxx
X‑DashScope‑Async	是	必须enable

请求参数

字段	类型	必填	说明
model	string	是	模型调用名称或模型ID
input	object	是	输入的基本信息，如提示词等。
input.prompt	string	否	正向提示词
input.negative_prompt	string	否	反向提示词
input.first_frame_url	string	是	首帧图像的URL或 Base64 编码数据。
input.last_frame_url	string	否	尾帧图像的URL或 Base64 编码数据。
input.template	string	否	视频特效模板的名称
parameters	object	否	视频处理参数，如设置视频分辨率、设置视频时长、开启prompt智能改写、添加水印等。
parameters.resolution	string	否	分辨率档位此参数的默认值和可用枚举值依赖于 model 参数，规则如下： - wan2.2-kf2v-flash：可选值：480P、720P、1080P。默认值为720P。
parameters.duration	int	否	视频生成时长，单位为秒。当前参数值固定为5，且不支持修改
parameters.prompt_extend	bool	否	是否开启 prompt 智能改写
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：任务不存在或状态未知

首尾帧生视频查询任务接口详情

模型：wan2.2‑kf2v‑flash

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
output.actual_prompt	string	当 prompt_extend=true 时，系统会对输入 prompt 进行智能改写，此字段返回实际用于生成的优化后 prompt。 - 若 prompt_extend=false，该字段不会返回。 - 注意：wan2.6 模型无论 prompt_extend 取值如何，均不返回此字段。
usage	object	用量统计，仅任务成功返回不同模型不同，详见如下
usage.video_duration	integer	生成视频的时长，单位为秒
usage.SR	integer	生成视频的分辨率。枚举值为 480、720、1080。
usage.video_count	integer	生成视频的数量。固定为 1。

请求/响应示例

首帧生视频示例

请求

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-i2v-flash",
    "input": {
        "prompt": "小猫在草地上奔跑，风吹动毛发",
        "img_url": "https://aaaa.ctyun.cn/pic/1.jpg",
        "audio_url": "https://aaaa.ctyun.cn/audio/1.mp3"
    },
    "parameters": {
        "resolution": "720P",
        "duration": 10
    }
}'

正常响应

{
    "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 --location 'https://ai.ctaigw.cn/v1/services/aigc/image2video/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer ${YOUR_APP_KEY}" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "wan2.2-kf2v-flash",
    "input": {
        "first_frame_url": "https://aaaa.ctyun.cn/pic/first_frame.png",
        "last_frame_url": "https://aaaa.ctyun.cn/pic/last_frame.png",
        "prompt": "小猫在草地上奔跑，风吹动毛发"
    },
    "parameters": {
        "resolution": "480P",
        "prompt_extend": true
    }
}'

正常响应示例

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

查询任务请求示例

请求

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": "小猫在草地上奔跑，风吹动毛发",
        "video_url": "https://aaaa.ctyun.cn/xxx.mp4"
    },
    "usage": {
        "duration": 10,
        "input_video_duration": 0,
        "output_video_duration": 10,
        "video_count": 1,
        "SR": 720
    }
}

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

星辰TokenHub运营服务平台

星辰TokenHub运营服务平台

支持的模型

调用流程

接口详情

首帧生视频创建接口详情

http调用

请求头

请求参数

响应参数

首帧生视频查询任务接口详情

http调用

Path 路径参数

请求头

响应参数

wan2.6系列模型返回的usage里的参数

wan2.2和wan2.5系列模型返回的usage里的参数

首尾帧生视频创建接口详情

http调用

请求头

请求参数

响应参数

首尾帧生视频查询任务接口详情

http调用

Path 路径参数

请求头

响应参数

请求/响应示例

首帧生视频示例

请求

正常响应

异常响应示例

首尾帧生视频示例

请求

正常响应示例

查询任务请求示例

请求

正常响应示例