跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Wan 3.0 视频 API

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

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

模型概览

模型名称 wan3.0-video
类型 视频生成（全能参考）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Wan 3.0 全能视频生成 API，支持文本、首尾帧、参考图片、视频、音频、文件和网页内容，输出 480P、720P 或 1080P 视频，并可生成同步音频。

生产建议

生产建议
  • 提交成功立即返回 taskId；生产环境可使用 callback.url 接收终态通知。
  • 本地调试或回调补偿时轮询 GET /v1/tasks/:id。
  • 参考视频的素材时长与输出时长合计不得超过 30 秒；首尾帧模式不能与参考素材数组混用。

适用场景

文本生成短片

用提示词描述完整场景、动作与镜头。

prompt
多模态参考控制

组合图片、视频或音频素材，并在提示词中按顺序引用。

promptreference_image_urlsreference_video_urlsreference_audio_urls
首尾帧过渡

用首帧和尾帧控制视频的开头与结尾。

first_frame_urllast_frame_url

请求参数

model string 必填

固定填 wan3.0-video。

示例 wan3.0-video
input object 必填

模型输入参数对象。

prompt string 必填

描述场景、动作、镜头、光线和声音；参考模式中按数组顺序使用 Image1、Video1 或 Audio1 指代素材。

first_frame_url string 可选

一个公开可访问的首帧图片 URL；不能与参考素材数组同时使用。

last_frame_url string 可选

与 first_frame_url 一起指定尾帧图片 URL。

reference_image_urls string[] 可选

最多 10 个公开可访问的参考图片 URL，用于全能参考生成。

reference_video_urls string[] 可选

最多 5 个参考视频 URL；单段 1-15 秒，合计不超过 15 秒。

reference_audio_urls string[] 可选

最多 5 个 WAV 或 MP3 参考音频 URL；请与图片或视频一起使用。

reference_file_urls string[] 可选

最多 1 个公开可访问的文档或演示文稿 URL。

reference_link_urls string[] 可选

最多 1 个无需登录即可访问的网页 URL。

resolution enum 可选

输出视频分辨率。

默认 1080P 可选值: 480P720P1080P
aspect_ratio enum 可选

输出画面比例；adaptive 根据素材和提示词选择。

默认 adaptive 可选值: adaptive16:94:31:13:49:16
duration integer 可选

输出时长，范围 2-30 秒；参考视频总时长加输出时长不得超过 30 秒。

默认 5
audio boolean 可选

是否在视频中包含同步音轨。

默认 true
seed integer 可选

用于需要复现结果时固定随机种子，范围 0-2147483647。

callback object 可选

可选的终态回调配置。

url string 必填

接收任务终态通知的 HTTPS 地址。

when enum 可选

回调触发时机。

默认 final 可选值: final

用例示例

文本生成 5 秒视频

使用黄金任务同源的低分辨率示例。

请求体
{
  "model": "wan3.0-video",
  "input": {
    "prompt": "月光下，一只小猫在屋顶奔跑，远处霓虹灯闪烁；电影感运镜，自然流畅。",
    "resolution": "480P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": true
  }
}
竖屏参考生成

使用参考素材时，将素材 URL 放入对应数组并在提示词中引用。

请求体
{
  "model": "wan3.0-video",
  "input": {
    "prompt": "Image1 中的角色在雨夜街道中向镜头走来。",
    "reference_image_urls": [
      "https://example.com/reference.jpg"
    ],
    "resolution": "720P",
    "aspect_ratio": "9:16",
    "duration": 5,
    "audio": true
  }
}

获取结果

  1. 提交 POST /v1/tasks 后立即得到 taskId。
  2. 任务成功后从 output[].url 下载视频。
  3. 任务失败时根据错误信息修正请求，不要重复提交同一无效参数。

常见问题

如何获取结果？

提交后取得 taskId；任务成功时从 output[].url 下载视频，或使用 callback.url 接收终态通知。

可以同时使用首帧和参考图吗？

首帧/尾帧模式与 reference_* 数组互斥；请根据素材用途选择一种模式。

下一步