Wan 3.0 Prime Reference-to-Video

Wan 3.0 Prime Reference-to-Video（通义万相 3.0 Prime 参考生视频）是阿里推出的新一代旗舰级图像可控视频生成大模型。模型采用全新的解耦时空注意力机制与多模态参考特征融合架构，支持输入多张参考图精准锁定主体身份、服装材质、光影氛围与镜头轨迹，并原生输出高帧率 4K 影视级画质。凭借极高的人特一致性控制与流畅的时空动作连贯性，广泛适用于电商广告视频创作、影视概念特效预览、动漫 IP 衍生开发与数字人短视频内容生产。

Wan 3.0 Prime reference-to-Video

Wan 3.0 Prime reference-to-Video（万相 3.0 Prime 参考生视频）是阿里巴巴通义万相系列推出的极速高品质 AI 参考生视频大模型。结合 Prime 架构的超高速渲染与 Wan 3.0 的全模态底座，模型支持单图首帧驱动与首尾帧平滑过渡，最高可直出 30 秒 1080P 高清视频。模型原生集成音视频联合生成（环境音效与多语言角色口型同步），在大幅缩短视频渲染等待时间的同时，具备高精度的动作物理仿真、镜头运镜控制与主体一致性保持，广泛适用于电商动态展示、影视特效、短剧快速迭代与商业广告创作。

Base URL

https://api.icreat.ai

认证

所有 API 请求需要通过 API Key 进行认证。您可以在控制台获取 API Key。

export ICREAT_API_KEY="your-api-key-here"

HTTP 请求头

import os

API_KEY = os.environ.get("ICREAT_API_KEY")
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer " + API_KEY,
}

保护好您的 API Key

切勿在客户端代码或公开仓库中暴露您的 API Key。请使用环境变量或后端代理。

代码示例

图片/视频生成采用二段式异步调用：先提交任务获取 task_id，再通过查询任务结果接口轮询进度；响应含 status 与 result（处理中为 []，SUCCEEDED 时 result 为资源列表且响应含 costUSD）。以下示例使用同一 task_id 串联两个步骤。

1. 提交任务

向提交接口发送生成请求。

POST/v1/task/submit/aliyun/wan3-0-prime/reference-to-video

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST https://api.icreat.ai/v1/task/submit/aliyun/wan3-0-prime/reference-to-video \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "x-icreat-ai-group: wan-spicy" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "prompt": "一只正在奔跑的小猫",
      "negative_prompt": "小猫不应该沿直线奔跑",
      "media": [
        {"type": "reference_image", "url": "..." }
        { "type": "reference_video", "url": "..." },
        { "type": "reference_audio", "url": "..." }
      ]
    },
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "watermark": false
    }
  }'

2. 查询任务结果（轮询）

使用提交步骤返回的 task_id 查询任务进度（可重复调用直至终态）。响应含 status 与 result：非终态或处理中时 result 为 []；SUCCEEDED 时 result 为资源数组且响应含 costUSD；FAILED 表示任务失败。

POST/v1/task/result

curl --fail-with-body --connect-timeout 10 --max-time 60 \
  -X POST "https://api.icreat.ai/v1/task/result" \
  -H "Authorization: Bearer ${ICREAT_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"task_id": "task-xxx"}'

输入参数

提交任务 — 输入参数

以下参数在提交任务请求体中被接受。

总计: 2 必填: 2 可选: 0

inputobject必填

生成任务的输入内容。

parametersobject必填

生成参数。

查询任务结果 — 输入参数

总计: 1 必填: 1 可选: 0

task_idstring必填

提交任务接口返回的任务 ID。

输出参数

提交任务 — 输出参数

总计: 1

task_idstring

提交任务接口返回的任务 ID。

查询任务结果 — 输出参数

总计: 可变

statusstring

当前任务状态。非成功时 result 通常为 []；SUCCEEDED 时 result 含资源项且响应含 costUSD。

SUBMITTEDSUCCEEDEDFAILED

resultarray[object]

生成资源列表。处理中或未成功时为 []；成功时为对象数组。

costUSDnumber

任务费用（美元），仅在 status 为 SUCCEEDED 时出现。

LLM友好的提示词

以下是一段 LLM 友好的 Markdown 提示词，可复制到 Cursor、ChatGPT 等 AI 助手中，帮助 AI 理解本模型的 API 接入方式、调用流程与关键参数。点击「复制LLM提示词」按钮或下方代码块均可复制全文。

# aliyun/wan3-0-prime/reference-to-video

> Wan 3.0 Prime reference-to-Video（万相 3.0 Prime 参考生视频）是阿里巴巴通义万相系列推出的极速高品质 AI 参考生视频大模型。

## 概述

通过 iCreat 二段式异步任务 API 提交生成请求，再轮询查询任务结果接口，成功时从 `result` 获取视频资源 URL（含 `costUSD`）。

## API 信息

- **Base URL**：`https://api.icreat.ai`
- **Submit endpoint (POST)**：`/v1/task/submit/aliyun/wan3-0-prime/reference-to-video`
- **Query result endpoint (POST)**：`/v1/task/result`
- **Model ID**：`aliyun/wan3-0-prime/reference-to-video`
- **认证**：`Authorization: Bearer ${ICREAT_API_KEY}`

## 调用流程

1. **Submit**：POST submit 路径，Body 见输入要点；响应 `{ "task_id": "..." }`
2. **Query result**：POST `/v1/task/result`，Body `{ "task_id": "..." }`；响应含 `status` 与 `result`（处理中 `result` 为 `[]`）；`SUCCEEDED` 时 `result` 为资源数组且含 `costUSD`，`type` 为 `Video` 时读取 `url` 或 `download_url`

### 输入要点

- 请求体顶层：`input`（object）+ `parameters`（object），二者为同级字段
- `input.prompt`（必填）：描述要生成视频的提示词。
- `input.negative_prompt`（可选）：描述不应出现在视频中的内容。
- `input.media`（可选）：参考媒体列表（图生视频时使用）。
- `parameters.resolution`（必填）：视频分辨率。
- `parameters.ratio`（必填）：视频宽高比。
- `parameters.duration`（必填）：视频时长（秒）。
- `parameters.watermark`（可选）：是否添加水印。

### 输出要点

- 轮询：看 `status`；`result` 处理中为 `[]`
- 成功：`result` 为 `[{ "type": "Video", "url": "...", "download_url": "..." }]`，并含 `costUSD`

## 注意事项

- 两步须用同一 `task_id` 串联；处理中 `result` 为 `[]`，需继续轮询
- `FAILED` 为终态，需排查请求参数或参考内容
- Submit 请求体中 `input` 与 `parameters` 为同级字段，不可嵌套混淆