Alibaba

Wan 2.7 Video

wan2.7-video/image-to-video

阿里 WAN 系列视频生成模型，支持文生、图生与参考引导视频，多参考输入可跨镜头保持人物与商品一致性

wan2.7-video/image-to-video wan2.7-video/text-to-video

试用 wan2.7-video/image-to-video

输入

作品灵感

查看全部作品

输出

video

填写参数并生成，结果会显示在这里。

价格

wan2.7-video/image-to-video 每秒

规格	单价
720P	$0.100
1080P	$0.167

定位简介

wan2.7-video/image-to-video 是 Alibaba WAN 视频系列中面向图像驱动的视频生成型号，通过 HiAPI.ai 统一接口调用。它以图片为起点生成视频，同时支持参考图/参考片段引导，可按提示词控制画面内容与运镜。输出分辨率可选 720P 或 1080P，单次时长 2 至 15 秒，支持首帧、尾帧、驱动音频与首段片段组合输入。适合需要以现有图片资产产出短片的开发者，用于广告素材、电商展示与分镜预演。

核心亮点

图片驱动生成，支持首尾帧控制——可同时指定首帧与尾帧图，约束镜头起止构图，减少随机性带来的重生成成本。
参考片段与驱动音频参与生成——除首尾帧外还可传入首段片段与驱动音频，让生成结果在运动节奏与声画上有所依据。
时长与分辨率可按需调节——单次生成时长在 2 至 15 秒之间设置，输出分辨率可选 720P 或 1080P，适配不同交付要求。

能力说明

图像到视频生成：以一张或多张图片作为画面依据，配合文本提示词生成视频，提示词最长 5000 字符，适合把已有视觉素材转为动态内容。

首帧尾帧组合控制：可在一次请求中同时指定首帧与尾帧，也可加入首段片段作为起始参考，用来限定镜头的起始与结束画面。

驱动音频输入：支持传入驱动音频作为媒体输入，让生成的视频在节奏上与给定声音素材对应，减少后期对轨环节。

提示词扩展与反向提示：prompt_extend 可开启提示词自动扩写，negative_prompt 可声明需要规避的画面元素，并可通过 seed 复现同一结果。

分辨率与时长参数化：输出分辨率与时长均为请求参数，同一接口内即可按场景切换 720P/1080P 与 2 至 15 秒的片段长度。

适用场景

电商与品牌方：以商品图生成动态展示——输入商品主图与展示要求，产出数秒的产品动态短片，用于详情页、信息流投放与社媒素材。
内容团队：角色或场景图转镜头片段——以角色设定图为首帧或参考，生成符合分镜描述的短镜头，用于短片、动画预演与创意提案。
设计团队：首尾帧约束的过渡镜头——同时给定起始画面与结束画面，生成两者之间的过渡片段，用于片头、转场与视觉方案演示。
音频素材方：音频驱动的画面生成——传入音频素材与画面描述，生成与声音节奏匹配的视频段落，用于音乐短视频与口播类内容。

限制与选型建议

单次生成时长上限为 15 秒，需要更长叙事时须分段生成并在后期拼接，跨片段一致性依赖提示词与参考素材控制。输出分辨率为 720P 与 1080P 两档，更高的画质需求需另行评估。媒体输入最多三项，且每种类型只能出现一次。若任务以纯文本创意为主、无需图像依据，可考虑同系列文本生视频型号；需要超长连续镜头时，本型号不是合适选择。

常见问题

查看全部常见问题 →

Wan 2.7 Image to Video 需要上传图片吗？

需要。当前 wan2.7-video/image-to-video 是图生视频线路，输入图负责主体和起始构图，Prompt 负责动作、镜头与环境变化。
Wan 2.7 Image to Video 支持哪些时长和分辨率？

当前 HiAPI 请求契约支持 2–15s，输出分辨率为 720P、1080P。可选值以页面参数面板和 API 文档为准。
Wan 2.7 Image to Video 如何计费？

任务按输出时长和所选档位计费。页面会跟随全局金额单位显示实时价格，最终扣费以成功任务记录为准。
怎样提高图生视频的主体稳定性？

使用主体清晰、遮挡较少且构图完整的输入图；Prompt 先描述主要动作和镜头，再列出必须保留的外观、材质与背景关系。首次测试建议使用较短时长。

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：wan2.7-video/image-to-video

routestring可选

当前固定值：default

inputobject必填

wan2.7-video/image-to-video 和线路 default 的业务参数对象，见下方参数表。

seedinteger可选min 0max 2147483647

随机种子，用于控制生成结果的随机性；取整数值，相同种子在其他参数一致时可复现相近结果。

mediaarray必填minItems 1maxItems 3

媒体输入数组，承载图生视频所需的各类素材；元素为带 url 与 type 的对象，支持的类型为 first_frame、last_frame、driving_audio、first_clip，每种类型最多出现一次。

Array [ object ]

数组元素

urlstring必填

媒体素材的地址，取公开 URL、OSS URL 或受支持的 base64 data URI 字符串。

typestring必填

该条媒体素材的类型，取字符串，用于标识其在生成流程中的角色（如首帧、尾帧、驱动音频、首片段）。

可选项：first_framelast_framedriving_audiofirst_clip

promptstring必填maxLength 5000

图生视频的文本提示词，描述期望生成的画面内容与动态效果。

durationinteger可选默认值: 5min 2max 15

生成视频的时长，单位为秒，取整数值，默认 5。

watermarkboolean可选默认值: false

是否在生成的视频上添加水印，取布尔值，默认 false。

resolutionstring可选默认值: "1080P"

生成视频的分辨率，取字符串；计费按秒计算且单价取决于该取值，默认 1080P。

可选项：720P1080P

prompt_extendboolean可选默认值: true

是否启用提示词扩写，开启后由模型对输入提示词进行自动扩展，取布尔值，默认 true。

negative_promptstring可选默认值: ""maxLength 500

反向提示词，用于描述不希望出现在生成视频中的内容，默认空字符串。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan2.7-video/image-to-video",
  "input": {
    "media": "…",
    "prompt": "…",
    "duration": 5,
    "watermark": false,
    "resolution": "1080P",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "wan2.7-video/image-to-video",
    input: {
      "media": "…",
      "prompt": "…",
      "duration": 5,
      "watermark": false,
      "resolution": "1080P",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "wan2.7-video/image-to-video",
        "input": {
          "media": "…",
          "prompt": "…",
          "duration": 5,
          "watermark": False,
          "resolution": "1080P",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}