通义万相2.2-首尾帧-Flash
ali/wan2.2-kf2v-flash
异步任务:POST /v1/tasks/generations 提交 → GET /v1/tasks/generations/{request_id} 轮询结果(POST 发送后 request_id 自动填入 GET)。
BASE URL
https://router.shengsuanyun.com/api认证方式
Authorization: Bearer YOUR_API_KEY端点列表
POST/v1/tasks/generationsAli 视频生成-异步
异步任务:POST 提交后返回 request_id,再用 GET /v1/tasks/generations/{request_id} 轮询结果。
请求体
application/json
| 字段 | 类型 | 说明 |
|---|---|---|
prompt | stringtextarea | 支持中英文,长度不超过800个字符。如果首尾帧的主体和场景变化较大,建议描写变化过程,例如运镜过程或者主体运动过程。 |
negative_prompt | stringtextarea | 用来描述不希望在视频画面中看到的内容,可以对视频画面进行限制。支持中英文,长度不超过500个字符。 |
first_frame_url必填 | string | 首帧图像的URL或Base64编码数据。输出视频的宽高比将以此图像为基准。支持JPEG、JPG、PNG、BMP、WEBP格式,分辨率范围[360, 2000]像素,文件大小不超过10MB。 |
last_frame_url | string | 尾帧图像的URL或Base64编码数据。支持JPEG、JPG、PNG、BMP、WEBP格式,分辨率范围[360, 2000]像素,文件大小不超过10MB。 |
resolution | string | 生成的视频分辨率档位,仅用于调整视频的清晰度,不改变视频的宽高比。注意:resolution直接影响费用,1080P > 720P > 480P。 可选值:"480P" · "720P" · "1080P" |
duration | integer | 视频生成时长,单位为秒。当前参数值固定为5,且不支持修改。注意:duration直接影响费用,按秒计费。 |
prompt_extend | boolean | 开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显,但会增加耗时。 |
seed | integer | 取值范围是[0, 2147483647]。未指定时,系统自动生成随机种子。若需提升生成结果的可复现性,建议固定seed值。 |
template | string | 视频特效模板的名称。使用此参数时,仅需传入first_frame_url。不同模型支持不同的特效模板,调用前请查阅视频特效列表,以免调用失败。示例值:hufu-1,表示使用'唐韵翩然'特效。 |
model必填 | string | 路由模型,本页固定为 ali/wan2.2-kf2v-flash |
{
"duration": 5,
"first_frame_url": "https://oss.shengsuanyun.com/example/modelinfo/224/2025-11-11_17:46:01_input_1.png",
"last_frame_url": "https://oss.shengsuanyun.com/example/modelinfo/224/2025-11-11_17:46:01_input_2.png",
"model": "ali/wan2.2-kf2v-flash",
"prompt": "一只黑色小猫好奇地看向天空,镜头从平视逐渐上升,过度平滑自然,最后俯拍小猫好奇的眼神。",
"prompt_extend": true,
"resolution": "480P"
}请求示例
参考地址: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 '{
"duration": 5,
"first_frame_url": "https://oss.shengsuanyun.com/example/modelinfo/224/2025-11-11_17:46:01_input_1.png",
"last_frame_url": "https://oss.shengsuanyun.com/example/modelinfo/224/2025-11-11_17:46:01_input_2.png",
"model": "ali/wan2.2-kf2v-flash",
"prompt": "一只黑色小猫好奇地看向天空,镜头从平视逐渐上升,过度平滑自然,最后俯拍小猫好奇的眼神。",
"prompt_extend": true,
"resolution": "480P"
}'响应
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/224/2025-11-11_17:46:01_output_3.mp4"
]
}