跳转到内容

Wan 3.0 Reference to Video

集成

模型 id alibaba/wan-3.0/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/alibaba/wan-3.0/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The fox from Image 1 runs through the forest from Video 1 at night, fireflies everywhere",
    "resolution": "720p",
    "duration": 5,
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

此请求: $0.50 500 API 积分 在此页面运行

获取 API 密钥
Alibaba 参考图生视频 原生音频参考输入2–30 秒最高 1080p #audio#references#long-clips

根据最多 10 张图片、5 个视频和 5 个音频片段构建 2 到 30 秒的 Wan 3.0 视频。

在 Doitong 上制作

Doitong 社区使用 Wan 3.0 制作的公开作品。一键复用提示词。

显示的公开作品:2
Create a realistic cinematic UGC-style commercial video, exactly 30 seconds long. The entire scen... 视频

Create a realistic cinematic UGC-style commercial video, exactly 30 seconds long. The entire scene takes place inside a modern passenger airplane during a daytime flight. Natural smartphone-like cinematography, realistic airplane cabin, authentic passengers, natural lighting, realistic skin...

Реалистичная бытовая сцена в советской одесской квартире зимним вечером. Женщина находится на кух... 视频

Реалистичная бытовая сцена в советской одесской квартире зимним вечером. Женщина находится на кухне, мужчина — в комнате и прихожей. Атмосфера обычной советской семьи перед приходом гостей. Голоса: все персонажи говорят по-русски с естественным, выразительным одесским говором. Характерная...

构建请求

控件根据模型架构生成。更改控件时,代码和价格会同步更新。

88 / 20000

描述如何使用参考媒体,在提示词中按位置标识各个参考对象。例如:'the subject in Image 1 walks past Video 1'。

reference_image_urls
拖放文件,或 · 最多 10 个

参考图像 URL,最多 10 个。

resolution

结果视频的分辨率级别。

aspect_ratio 默认 adaptive

输出宽高比,可选择自适应。

输出时长:null 会根据提示词和参考媒体启用智能时长;否则,提供的值指定秒数。

高级 videos · audios · file_url · web_url · seed · generate_audio · enable_prompt_expansion · enable_thinking
reference_video_urls
拖放文件,或 · 最多 5 个

提供帧率为 16 fps 或更高的参考片段 URL。最多可包含 5 个视频,所有素材总时长不超过 15 秒。

reference_audio_urls
拖放文件,或 · 最多 5 个

参考音频 URL,最多 5 个,总时长不超过 15 秒。

拖放文件,或

作为视频依据的文档 URL。要求 enable_thinking 为 true。

作为视频依据的网页 URL;仅支持无需登录即可读取且 enable_thinking=true 的网页。

POST /run/alibaba/wan-3.0/reference-to-video?wait=20 报价 → $0.50
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/alibaba/wan-3.0/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The fox from Image 1 runs through the forest from Video 1 at night, fireflies everywhere",
    "resolution": "720p",
    "duration": 5,
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

运行此请求

你的密钥会保留在此浏览器中:仅发送到 Doitong API;只有勾选“记住”后才会保存到 localStorage。 获取 API 密钥

关于 Wan 3.0 Reference to Video

Wan 3.0 参考图转视频将参考图片、短参考视频(总计 15 秒)和 参考音频组合成一个生成片段;在提示词中按位置引用它们(Image 1、Video 1)。启用 推理步骤后,还可根据文档或公共网页生成视频。480p 到 1080p,2 到 30 秒,默认生成音频。

参数

发送规范名称或原生名称之一,不要同时发送两者。 规范名称

名称类型 默认值允许值 描述
prompt可选
类型string | null
≤ 20,000 个字符
描述如何使用参考媒体,在提示词中按位置标识各个参考对象。例如:'the subject in Image 1 walks past Video 1'。
resolution可选
类型enum
默认值1080p
480p720p1080p
结果视频的分辨率级别。
aspect_ratio可选
类型enum
默认值adaptive
adaptive16:94:31:13:49:16
输出宽高比,可选择自适应。
duration可选
类型integer | null
默认值5
2 – 30
输出时长:null 会根据提示词和参考媒体启用智能时长;否则,提供的值指定秒数。
audio可选 generate_audio
类型boolean
默认值true
控制是否包含生成的音频。
enable_prompt_expansion可选
类型boolean
默认值true
控制生成前是否智能重写提示词。禁用重写预计会降低质量,但可减少约 20–60 秒延迟。
enable_thinking可选
类型boolean
默认值false
在开始生成前启用额外推理。
seed可选
类型integer | null
0 – 2,147,483,647
reference_image_urls可选 images
类型url[] · image
≤ 10 个项目
参考图像 URL,最多 10 个。
reference_video_urls可选 videos
类型url[] · video
≤ 5 个项目
提供帧率为 16 fps 或更高的参考片段 URL。最多可包含 5 个视频,所有素材总时长不超过 15 秒。
reference_audio_urls可选 audios
类型url[] · audio
≤ 5 个项目
参考音频 URL,最多 5 个,总时长不超过 15 秒。
file_url可选
类型url · file
作为视频依据的文档 URL。要求 enable_thinking 为 true。
web_url可选
类型string | null
作为视频依据的网页 URL;仅支持无需登录即可读取且 enable_thinking=true 的网页。
必填 规范名称,也可接受

文件参数接受公开的 https:// URL、最大 10 MB 的 data: URI,或上传文件的 file_url。 文件

输出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "alibaba/wan-3.0/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 500,
    "usd": "0.50",
    "charged": 500,
    "refunded": 0
  },
  "input": {
    "prompt": "The fox from Image 1 runs through the forest from Video 1 at night, fireflies everywhere",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ],
    "duration": 5,
    "resolution": "720p"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "seed": 42,
    "duration": 5,
    "actual_prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
你的文件,由你选择每个 outputs[].url 都是存储中的副本:可永久保存(按 GB-月付费),也可免费保存 7 天,由账户设置或 ?storage= 决定。
每个模型的结构相同图像、视频和音频均包含 type、url、content_type、width、height 和 duration。output 是模型自身的结果对象。
输出字段
video
object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames}生成得到的视频文件。
seed
integer生成期间应用的种子值。
duration
number生成视频的时长,单位为秒。
actual_prompt
string | null

更多模型:参考图生视频

对于 AI 代理:此页面的 Markdown 版本位于 https://doitong.com/zh/developers/models/alibaba/wan-3.0/reference-to-video.md. 所有模型和指南: https://doitong.com/developers/llms.txt