Wan 2.6 图生视频

POST /v3/async/wan2.6-i2v

Wan 2.6 图生视频

cURL

curl --request POST \
  --url https://api.highwayapi.ai/v3/async/wan2.6-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "input": {
    "prompt": "<string>",
    "img_url": "<string>",
    "template": "<string>",
    "audio_url": "<string>",
    "negative_prompt": "<string>"
  },
  "parameters": {
    "seed": 123,
    "audio": true,
    "duration": 123,
    "shot_type": "<string>",
    "watermark": true,
    "resolution": "<string>",
    "prompt_extend": true
  }
}
'

200

{
  "task_id": "<string>"
}

这是一个异步 API，仅返回异步 task_id。你需要使用 task_id 调用任务结果查询 API 获取视频生成结果。

这是一个异步API，只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索生成结果。

​

请求头

Content-Type · string · 必填

枚举值: application/json

Authorization · string · 必填

Bearer 身份验证格式: Bearer {{API 密钥}}。

​

请求体

input · object · 必填

隐藏 properties

prompt · string

文本提示词，用来描述生成视频中期望包含的元素和视觉特点。支持中英文，每个汉字/字母占一个字符，超过部分会自动截断。

长度限制：0 - 2000

img_url · string · 必填

输入图片的 URL 或 Base64 编码数据。支持 HTTP 或 HTTPS 协议，本地文件可通过上传文件获取临时 URL。图像限制：图像格式：JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP；图像分辨率：图像的宽度和高度范围为[360, 2000]，单位为像素；文件大小：不超过 10MB。输入图像说明：1. 使用公网访问 URL - 支持 HTTP 或 HTTPS 协议，本地文件可通过上传文件获取临时 URL；示例：https://cdn.translate.alibaba.com/r/wanx-demo-1.png。2. 传入 Base64 编码图像后的字符串 - 数据格式：data:;base64,；示例：data:image/png;base64,GDU7MtCZEbTbmRZ…（编码字符串过长，仅展示片段）。更多内容请参见输入图像。

template · string

视频特效模板的名称。若未填写，表示不使用任何视频特效。不同模板支持不同的特效模板，调用前请查询视频特效列表，以免调用失败。

audio_url · string

音频文件URL，模型将使用该音频生成视频。支持HTTP或HTTPS协议。音频限制：格式为wav、mp3；时长3～30s；文件大小不超过15MB。超限处理：若音频长度超过duration值（5秒或10秒），自动截取前5秒或10秒，其余部分丢弃。若音频长度不足视频时长，超出音频长度部分为无声视频。例如，音频为3秒，视频时长为5秒，输出视频前3秒有声，后2秒无声。

negative_prompt · string

反向提示词，用来描述不希望在视频画面中看到的内容，可以对视频画面进行限制。支持中英文，长度不超过500个字符，超过部分会自动截断。

长度限制：0 - 500

parameters · object

隐藏 properties

seed · integer

随机数种子。取值范围为[0, 2147483647]。未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。请注意，由于模型生成具有概率性，即使使用相同seed，也不能保证每次生成结果完全一致。

取值范围：[0, 2147483647]

audio · boolean · 默认值: true

用于控制是否添加音频。参数优先级：audio_url > audio，仅在audio_url为空时生效，使用方式参见音频设置。true：默认值，自动为视频添加音频；false：不添加音频，输出无声视频。

duration · integer · 默认值: 5

生成视频的时长，单位为秒。duration直接影响费用，请在调用前确认模型价格。生成视频的时长，单位为秒。

可选值：5, 10, 15

shot_type · string · 默认值: "multi"

视频生成模式。single：单镜头生成；multi：多镜头生成。

可选值：single, multi

watermark · boolean · 默认值: false

是否添加水印标识，水印位于视频右下角，文案固定为”AI 生成”。false：默认值，不添加水印；true：添加水印。

resolution · string · 默认值: "1080P"

指定生成视频的分辨率档位。支持720P、1080P三个档位。

可选值：720P, 1080P

prompt_extend · boolean · 默认值: true

是否开启prompt智能改写。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显，但会增加耗时。true：默认值，开启智能改写；false：不开启智能改写。

​

响应信息

task_id · string · 必填

使用 task_id 请求 查询任务结果 API 来检索生成的输出。