跳转到内容
中文

Wan 2.6 Flash 图生视频 API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过统一异步接口 POST /v1/tasks 调用,区别只在 input 字段(见下方 input 参数)。

模型概览

模型 wan2.6-flash/image-to-video
能力 单图生视频 + 可选音频
分辨率 720p / 1080p
时长 5 / 10 / 15 秒

上传一张图片并描述动作,生成 5、10 或 15 秒的 720p 或 1080p 视频,可按需开启同步音频。

生产建议

调用建议
  • 先用 720p、5 秒、无音频确认动作,再切到 1080p、更长时长或开启音频。
  • 想要竖屏就传竖图,输出画幅跟随图片。
  • 使用 callback.url 接收任务完成或失败通知;查询响应从 data 读取任务对象,回调正文直接读取任务对象。
  • 产物 URL 有有效期,需要长期保存时请转存到自己的存储。

适用场景

图片动起来

人物、动物、产品和风景图加上自然动作与运镜。

image_urlsprompt
有声短片

开启 audio 生成同步环境声和音效。

audio
较长镜头

最长 15 秒,适合完整动作和场景氛围。

duration

请求参数

model string 必填

模型 ID。

示例 wan2.6-flash/image-to-video
input object 必填

图生视频参数。

prompt string 必填

描述动作、镜头和氛围,中英文均可,最多 1,500 字符。

image_urls string[] 必填

1 个以 http:// 或 https:// 开头的公网图片 URL,作为视频起始画面。JPG/PNG/WebP,至少 256×256,不超过 10MB;输出画幅跟随图片。

duration enum 可选

视频时长(秒):5、10 或 15。按秒计费。

默认 5 可选值: 51015
resolution enum 可选

输出分辨率。

默认 720p 可选值: 720p1080p
audio boolean 可选

是否生成与画面同步的音频(环境声、音效)。开启后按有声档计费。

默认 false
callback object 可选

任务完成或失败后发送通知;查询响应从 data 读取任务对象,回调正文直接读取任务对象。

url string 必填

接收任务完成或失败通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

任务完成或失败时触发。

默认 final 可选值: final

用例示例

默认无声

720p、5 秒、无音频。

请求体
{
  "model": "wan2.6-flash/image-to-video",
  "input": {
    "prompt": "The fox turns its head toward the camera, its ears twitch, golden leaves drift down through the misty light",
    "image_urls": [
      "https://example.com/start.jpg"
    ]
  }
}
1080p 有声

开启音频,1080p。

请求体
{
  "model": "wan2.6-flash/image-to-video",
  "input": {
    "prompt": "The vendor tosses the noodles in the wok, flames flare up, the crowd chatters",
    "image_urls": [
      "https://example.com/start.jpg"
    ],
    "resolution": "1080p",
    "audio": true
  }
}

获取结果

  1. 创建任务响应从 data.taskId 读取任务 ID。
  2. 等待 callback,或调用 GET /v1/tasks/:id 查询状态;轮询响应从 data 读取任务对象。
  3. status=success 时,从 output 中读取 type=video 的视频 URL;callback body 直接读取 output。

常见问题

开启 audio 会改变价格吗?

会。有声视频按有声档每秒计费,关闭时按无声档计费;当前价格见价格页。

输出画幅可以设置吗?

不需要设置,画幅跟随输入图片。

可以传多张图吗?

不可以,image_urls 只接受 1 张图片。

支持哪些时长?

5、10、15 秒,默认 5 秒。

下一步