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

Wan 3.0 Prime 视频 API

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

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

模型概览

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

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

生产建议

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

适用场景

快速出片

用提示词描述完整场景、动作与镜头，以更短的等待时间获得成片。

prompt
图片与音频参考

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

promptreference_image_urlsreference_audio_urls
首尾帧过渡

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

first_frame_urllast_frame_url

请求参数

model string 必填

固定填 wan3.0-video-prime。

示例 wan3.0-video-prime
input object 必填

模型输入参数对象。

prompt string 必填

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

first_frame_url string 可选

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

示例 https://example.com/first-frame.jpg
last_frame_url string 可选

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

示例 https://example.com/last-frame.jpg
reference_image_urls string[] 可选

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

示例 ["https://example.com/reference.jpg"]
reference_audio_urls string[] 可选

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

示例 ["https://example.com/voice.mp3"]
reference_file_urls string[] 可选

最多 1 个公开可访问的文档或演示文稿 URL；不能与 reference_link_urls 同时使用。

示例 ["https://example.com/brand-guide.pdf"]
reference_link_urls string[] 可选

最多 1 个无需登录即可访问的网页 URL；不能与 reference_file_urls 同时使用。

示例 ["https://example.com/product-page"]
resolution enum 可选

输出视频分辨率。

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

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

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

输出时长，范围 2-30 秒。

默认 5
audio boolean 可选

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

默认 true 示例 false
seed integer 可选

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

callback object 可选

可选的终态回调配置。

url string 必填

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

when enum 可选

回调触发时机。

默认 final 可选值: final

用例示例

文本生成 2 秒视频

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

请求体
{
  "model": "wan3.0-video-prime",
  "input": {
    "prompt": "阳光下咖啡馆桌上的一杯冰抹茶拿铁；镜头缓慢推进，杯壁水珠滑落，木勺轻轻搅动，柔和虚化，温暖晨光，轻柔的咖啡馆环境音。",
    "resolution": "480P",
    "aspect_ratio": "16:9",
    "duration": 2,
    "audio": true
  }
}
竖屏参考生成

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

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

用首帧和尾帧控制开头与结尾，固定 seed 便于复现；首尾帧模式不能与 reference_* 数组同时使用。请把示例 URL 替换为可公开访问的图片。

请求体
{
  "model": "wan3.0-video-prime",
  "input": {
    "prompt": "清晨的花苞在阳光下缓慢绽放成盛开的花朵，镜头固定，柔和自然光，轻微的风声。",
    "first_frame_url": "https://example.com/first-frame.jpg",
    "last_frame_url": "https://example.com/last-frame.jpg",
    "resolution": "720P",
    "aspect_ratio": "16:9",
    "duration": 5,
    "audio": true,
    "seed": 42
  }
}
参考图片 + 音频 + 文档

参考图片提供人物外观，参考音频提供人物声音，文档提供品牌信息；提示词按顺序用 Image1、Audio1 引用素材。reference_file_urls 与 reference_link_urls 只能二选一。请把示例 URL 替换为可公开访问的素材。

请求体
{
  "model": "wan3.0-video-prime",
  "input": {
    "prompt": "Image1 中的主持人在明亮的演播室里面对镜头介绍新品，用 Audio1 的声音说话，画面风格符合文档中的品牌规范。",
    "reference_image_urls": [
      "https://example.com/reference.jpg"
    ],
    "reference_audio_urls": [
      "https://example.com/voice.mp3"
    ],
    "reference_file_urls": [
      "https://example.com/brand-guide.pdf"
    ],
    "resolution": "1080P",
    "aspect_ratio": "16:9",
    "duration": 8,
    "audio": true
  }
}
参考图片 + 网页

参考图片提供产品外观，网页提供产品信息；网页需无需登录即可访问。请把示例 URL 替换为可公开访问的素材。

请求体
{
  "model": "wan3.0-video-prime",
  "input": {
    "prompt": "Image1 中的产品在纯色背景上缓慢旋转展示，结合网页中的产品卖点呈现细节特写。",
    "reference_image_urls": [
      "https://example.com/reference.jpg"
    ],
    "reference_link_urls": [
      "https://example.com/product-page"
    ],
    "resolution": "720P",
    "aspect_ratio": "1:1",
    "duration": 5,
    "audio": false
  }
}

获取结果

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

常见问题

如何获取结果？

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

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

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

和 wan3.0-video 有什么区别？

Prime 是加速版线路，参数与输出规格相同，生成更快；目前不接收参考视频输入。

下一步