Wan-AI/Wan2.5-I2V
图生视频模型
异步提交任务
接口
https://api.modelverse.cn/v1/tasks/submit
输入
参数 | 类型 | 是否必选 | 描述 |
---|---|---|---|
model | string | 是 | 模型名称,此处为 Wan-AI/Wan2.5-I2V |
input.negative_prompt | string | 否 | 反向提示词,用于限制不希望出现的内容 |
input.first_frame_url | string | 是 | 视频首帧图片 URL |
input.audio_url | string | 否 | 音频 URL,用于指导生成。如果音频时长超过指定的视频时长,将被截断;如果短于视频时长,视频后半部分将无声。 |
input.prompt | string | 是 | 提示词,用于指导视频生成 |
parameters.resolution | string | 是 | 视频分辨率选择,支持:480p, 720p, 1080p |
parameters.duration | int | 否 | 视频生成时长(秒),可选值 5 或 10 ,默认为 5 |
parameters.enable_prompt_expansion | boolean | 否 | 是否启用提示词优化,默认为 false |
parameters.seed | int | 否 | 随机数种子,范围[-1, 2147483647] ,-1表示随机 |
请求示例
⚠️ 如果您使用 Windows 系统,建议使用 Postman 或其他 API 调用工具。
curl --location --globoff 'https://api.modelverse.cn/v1/tasks/submit' \
--header 'Authorization: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "Wan-AI/Wan2.5-I2V",
"input": {
"first_frame_url": "https://umodelverse-inference.cn-wlcb.ufileos.com/ucloud-maxcot.jpg",
"audio_url": "https://umodelverse-inference.cn-wlcb.ufileos.com/%E9%94%A6%E7%91%9F.mp3",
"prompt": "make it swim"
},
"parameters": {
"resolution": "720p",
"duration": 5
}
}'
输出
参数 | 类型 | 描述 |
---|---|---|
output.task_id | string | 异步任务的唯一标识 |
request_id | string | 请求的唯一标识 |
响应示例
{
"output": {
"task_id": "task_id"
},
"request_id": "request_id"
}
查询任务状态
接口
https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>
请求示例
curl --location 'https://api.modelverse.cn/v1/tasks/status?task_id=<task_id>' \
--header 'Authorization: <YOUR_API_KEY>'
输出
参数 | 类型 | 描述 |
---|---|---|
output.task_id | string | 异步任务的唯一标识 |
output.task_status | string | 任务状态:Pending ,Running ,Success ,Failure |
output.urls | array | 视频结果的 URL 列表 |
output.submit_time | integer | 任务提交时间戳 |
output.finish_time | integer | 任务完成时间戳 |
output.error_message | string | 失败时返回的错误信息 |
usage.duration | integer | 任务执行时长(秒) |
request_id | string | 请求的唯一标识 |
响应示例
{
"output": {
"task_id": "task_id",
"task_status": "Success",
"urls": ["https://xxxxx/xxxx.mp4"],
"submit_time": 1756959000,
"finish_time": 1756959050
},
"usage": {
"duration": 5
},
"request_id": ""
}