Kling 4.0 现已上线 — 真实到难以置信的视频 | 立即体验 →
Alibaba视频 API$0.03/次起

Wan 2.5 API

阿里巴巴 Wan 2.5——最高 1080p 的文生视频和图生视频,带同步音频,同系列还有 video-extend、image-edit 和 text-to-image,视频端点均有 Fast 变体。

本 Wan 2.5 API 指南介绍 WaveSpeedAI 上已上线的端点:带 Fast 变体的文生视频、图生视频和 video-extend,以及 image-edit 和 text-to-image。下方的 Playground、示例、价格和 API 代码示例均使用已上线的 Wan 2.5 端点。

概览

关于 Wan 2.5 API

Wan 2.5 能做什么、它在 Alibaba 模型阵容中的定位,以及团队选择它的原因。

Wan 2.5 是 Alibaba 推出的视频生成模型,可通过 WaveSpeedAI REST API 使用。阿里巴巴 Wan 2.5——最高 1080p 的文生视频和图生视频,带同步音频,同系列还有 video-extend、image-edit 和 text-to-image,视频端点均有 Fast 变体。

本 Wan 2.5 API 指南介绍 WaveSpeedAI 上已上线的端点:带 Fast 变体的文生视频、图生视频和 video-extend,以及 image-edit 和 text-to-image。下方的 Playground、示例、价格和 API 代码示例均使用已上线的 Wan 2.5 端点。

WaveSpeedAI 上的 Wan 2.5 系列提供 8 个 REST 端点,涵盖 Image-To-Image, Text-To-Image, Video-Extend, Text-To-Video, Image-To-Video 个工作流。每个变体都有各自的定价、参数选项和示例输出——请选择与你的输入模态和生产约束相匹配的那一个,或使用同一个 API 密钥调用多个变体,组合成多步骤流水线。

使用与 WaveSpeedAI 上其他 1,000 多个 AI 模型相同的 API 密钥、账单账户和速率限制来运行 Wan 2.5。无需单独对接供应商,无需各家 SDK,也无需应对各家不同的速率限制——一次集成即可覆盖从文生图、文生视频到音频合成、3D 生成、放大和编辑的全部能力。

规格

Wan 2.5 API 的能力与发布状态

开发者在选择 API 之前会搜索的模型细节:可用性、预期输出时长、参考素材支持情况,以及当前可用的在线替代方案。

可用性

已上线

Wan 2.5 端点已在 WaveSpeedAI 目录中上线:文生视频、图生视频和 video-extend(均有 Fast 变体)、image-edit 和 text-to-image,全部使用同一套 REST 预测流程。

分辨率

480p、720p、1080p

视频输出可选 480p、720p 和 1080p,视端点而定;文生视频在每个分辨率下都提供横版和竖版尺寸。

时长

3 到 10 秒

文生视频生成 5 或 10 秒的片段;图生视频 Fast 和 video-extend 生成 3 到 10 秒。

音频

同步音频

视频端点会生成与画面同步的音频,也可选择提供音频文件(WAV 或 MP3,至少 3 秒,最大 15 MB)来引导生成。

Fast 变体

文生、图生和延长

Wan 2.5 Fast 适用于文生视频、图生视频和 video-extend,定位为更快、更实惠的生成。

图像工具

编辑和 text-to-image

image-edit 可配合提示词接受最多两张输入图像,text-to-image 则在与视频端点相同的系列中生成静态图。

端点

全部 Wan 2.5 API 端点

WaveSpeedAI 现已提供 8 个 Wan 2.5 端点——请选择适合你工作流的变体。

image-to-imageWan 2.5 Image Edit — Alibaba 的 Wan 2.5 image-to-image 预览

Wan 2.5 Image Edit

Refine existing visuals with WAN 2.5 image-edit using prompt-driven adjustments and stylistic upgrades for photos and graphics. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.035 起
text-to-imageWan 2.5 Text To Image — Alibaba 的 Wan 2.5 text-to-image 预览

Wan 2.5 Text To Image

WAN 2.5 Text-to-Image turns text prompts into AI-generated images with the WAN 2.5 model for on-demand image creation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.03 起
video-extendWan 2.5 Video Extend Fast — Alibaba 的 Wan 2.5 video-extend 预览

Wan 2.5 Video Extend Fast

WAN 2.5 Fast is an AI-powered video extender that turns short clips into longer videos while preserving audio tracks for seamless extensions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.068 起
video-extendWan 2.5 Video Extend — Alibaba 的 Wan 2.5 video-extend 预览

Wan 2.5 Video Extend

WAN 2.5 Video-Extend turns short clips into longer videos with preserved or generated synchronized audio for continuity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.10 起
text-to-videoWan 2.5 Text To Video — Alibaba 的 Wan 2.5 text-to-video 预览

Wan 2.5 Text To Video

WAN 2.5 makes 480p-1080p text/image-to-video with synced audio and is faster, more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.10 起
text-to-videoWan 2.5 Text To Video Fast — Alibaba 的 Wan 2.5 text-to-video 预览

Wan 2.5 Text To Video Fast

WAN 2.5 Fast creates synchronized-audio videos from text or images in 720p, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.068 起
image-to-videoWan 2.5 Image To Video Fast — Alibaba 的 Wan 2.5 image-to-video 预览

Wan 2.5 Image To Video Fast

WAN 2.5 Fast converts text or images into synchronized-audio videos in 480p, 720p, or 1080p, offering faster, more affordable generation compared to Google Veo3. REST API, no coldstarts, affordable pricing.

$0.068 起
image-to-videoWan 2.5 Image To Video — Alibaba 的 Wan 2.5 image-to-video 预览

Wan 2.5 Image To Video

WAN 2.5 converts text or images into videos (480p/720p/1080p) with synced audio, faster and more affordable than Google Veo3. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

$0.10 起

示例

看看 Wan 2.5 的实际效果

由 Wan 2.5 API 生成的真实输出。悬停在任意视频上即可预览,点击可打开全尺寸查看器。

使用方法

如何使用 Wan 2.5 API

从注册到完成一次生成,只需四步。完整的 Python、Node.js 和 cURL 示例见下方的 API 部分。

  1. 01

    获取 API 密钥

    注册 WaveSpeedAI 账号,并从控制台复制你的 API 密钥。新账号附带免费体验额度——足够在开始计费前把 Playground 运行几十次。

  2. 02

    提交预测

    把你的输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video。端点会立即返回预测 ID——生成是异步的,因此推理期间你无需保持连接。

  3. 03

    轮询完成状态

    GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result。状态为 completed 时返回输出;状态为 failed、cancelled、timeout 或 deleted 时以错误终止;其他任何状态都继续轮询。

  4. 04

    读取输出 URL

    状态变为 "completed" 后,从 data.outputs[0] 读取 URL。该 URL 指向 WaveSpeedAI CDN 上你生成的媒体——具体是图片、视频、音频还是 3D 文件,取决于你调用的 Wan 2.5 变体。

应用场景

用 Wan 2.5 可以构建什么

开发者和创作者使用 Wan 2.5 API 的常见工作流。

01

带同步音频的文生视频

alibaba/wan-2.5/text-to-video 把提示词转成最高 1080p 的 5 或 10 秒片段,音频与画面一同生成。

text-to-videoaudio
02

由静态图生成视频

alibaba/wan-2.5/image-to-video 及其 Fast 变体根据提示词让参考图像动起来,Fast 端点支持 720p 或 1080p,时长 3 到 10 秒。

image-to-videofast
03

延长片段

alibaba/wan-2.5/video-extend 以保留或新生成的同步音频接续现有视频,支持 480p、720p 或 1080p,Fast 变体以更低成本完成同样的工作。

video-extendcontinuity
04

用你自己的音频引导片段

向视频端点传入音频文件来塑造生成结果,例如让动作跟随一句台词或一段节拍。

audio-guidedlip-sync
05

同系列内编辑图像

alibaba/wan-2.5/image-edit 对一张或两张图像执行提示词驱动的编辑,让静态图和视频出自同一个模型系列。

image-editstylistic
06

用 text-to-image 生成静态图

alibaba/wan-2.5/text-to-image 根据提示词生成图像,尺寸以像素设定,最高 2880。

text-to-imagestills

技巧

Wan 2.5 提示词技巧

让 Wan 2.5 输出更好结果的实用建议——总结自生产流水线中各类视频模型都适用的做法。

  1. 01

    用 Fast 打样,用标准端点交付

    先用 Fast 变体测试提示词和动作,再用标准端点生成最终片段。

  2. 02

    按平台选择尺寸

    文生视频在 480p、720p 和 1080p 下都提供横版和竖版尺寸,生成前请按片段的播放场景选择尺寸。

  3. 03

    用音频控制节奏

    一段至少 3 秒的短 WAV 或 MP3 可以引导生成,当动作需要跟随台词或节拍时很有用。

  4. 04

    分小步延长

    使用 video-extend 时,每次只延长几秒,并描述接下来发生的内容,让每一步都保持场景和音频的连贯。

定价

Wan 2.5 API 定价

按输出计费。最终费用会随你在各变体 Playground 中设置的参数(分辨率、时长、输出数量、参考素材)而变化。

起步价

$0.03/ 次

8 个端点 · Wan 2.5

打开 Playground
端点类型起步价
alibaba/wan-2.5/image-editimage-to-image$0.035
alibaba/wan-2.5/text-to-imagetext-to-image$0.03
alibaba/wan-2.5/video-extend-fastvideo-extend$0.068
alibaba/wan-2.5/video-extendvideo-extend$0.10
alibaba/wan-2.5/text-to-videotext-to-video$0.10
alibaba/wan-2.5/text-to-video-fasttext-to-video$0.068
alibaba/wan-2.5/image-to-video-fastimage-to-video$0.068
alibaba/wan-2.5/image-to-videoimage-to-video$0.10

API

调用 Wan 2.5 API

在 wavespeed.ai/accesskey 注册并获取 API 密钥,然后通过 REST 提交预测。Playground 可以为任意输入组合生成可直接粘贴的示例代码。

POSThttps://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1280*720",
    "duration": 5,
    "enable_prompt_expansion": false
}')

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done

对比

Wan 2.5 与其他方案对比

在 WaveSpeedAI 上,何时应选择 Wan 2.5 而不是同类模型。

Wan 2.5 对比 Wan 2.7

Wan 2.7 是较新的一代,更多端点支持 reference-to-video、video-edit 和 1080p 输出。Wan 2.5 仍是带 Fast 变体和同步音频的选择。

Wan 2.5 对比 Veo 3.1

目录将 Wan 2.5 定位为比 Google Veo 3 更快、更实惠,支持音频引导生成和 video-extend。Veo 3.1 在 1080p 下提供 Standard、Fast 和 Lite 档位。

Wan 2.5 对比 Kling 2.6

Kling 2.6 增加了运动控制端点和 create-voice 端点。Wan 2.5 在同一系列中涵盖 480p 到 1080p 的同步音频视频、video-extend、image-edit 和 text-to-image。

常见问题

Wan 2.5 API — 常见问题

定价、许可、集成——关于在 WaveSpeedAI 上运行 Wan 2.5 的常见问题。

Wan 2.5 支持哪些分辨率?

视频端点输出 480p、720p 和 1080p,视端点而定。文生视频还提供竖版尺寸,图生视频 Fast 输出 720p 或 1080p。

Wan 2.5 会生成音频吗?

会。视频端点生成与画面同步的音频,你也可以选择发送音频文件来引导结果。

Wan 2.5 Fast 是什么?

文生视频、图生视频和 video-extend 的 Fast 变体,定位为比标准变体更快、更实惠的生成。

可以用 Wan 2.5 延长现有视频吗?

可以。video-extend 端点把一段短片续成更长的片段,以保留或新生成的同步音频接续,并且有 Fast 变体。

Wan 2.5 API 是什么?

Wan 2.5 是 Alibaba 的视频生成模型,在 WaveSpeedAI 上以 REST API 形式提供。阿里巴巴 Wan 2.5——最高 1080p 的文生视频和图生视频,带同步音频,同系列还有 video-extend、image-edit 和 text-to-image,视频端点均有 Fast 变体。你可以通过编程方式调用它,也可以在上方链接的 Playground 中试用。

如何调用 Wan 2.5 API?

注册 WaveSpeedAI 账号,从 /accesskey 复制你的 API 密钥,然后把输入以 JSON 形式 POST 到 https://api.wavespeed.ai/api/v3/alibaba/wan-2.5/text-to-video。端点会返回预测 ID。从大约每 2 秒一次开始轮询结果端点,长耗时任务可适当拉长间隔,并在任何终止状态时停止。上方有面向生产环境的 Python / Node.js / cURL 示例。

Wan 2.5 API 的费用是多少?

Wan 2.5 每次调用 $0.03 起。实际费用会随你设置的参数(分辨率、时长、输出数量、参考素材)而变化。Playground 中“生成”按钮旁的实时费用预览会显示你当前输入对应的准确价格。

有哪些 Wan 2.5 变体可用?

WaveSpeedAI 托管了 8 个已上线的 Wan 2.5 端点:alibaba/wan-2.5/image-edit, alibaba/wan-2.5/text-to-image, alibaba/wan-2.5/video-extend-fast, alibaba/wan-2.5/video-extend, alibaba/wan-2.5/text-to-video, alibaba/wan-2.5/text-to-video-fast, alibaba/wan-2.5/image-to-video-fast, alibaba/wan-2.5/image-to-video。每个变体都有自己的 Playground 页面和定价。

Wan 2.5 的输出可以商用吗?

商用权利遵循 Alibaba 的模型许可。大多数 Alibaba 模型允许商用输出;具体许可摘要请查看各模型的 Playground 页面,平台层面的条件请参阅 WaveSpeedAI 的服务条款。

为什么要在 WaveSpeedAI 上使用 Wan 2.5,而不是直接对接?

一个 API 密钥、一个账单账户,即可使用 Wan 2.5 以及来自其他提供方的 1,000 多个 AI 模型。无需逐家配置 SDK,无需应对各自独立的速率限制,也无需为每家重写集成代码。价格通常与 Alibaba 直接提供的 API 持平或更低。

提供方

关于 Alibaba

Wan 2.5 及 WaveSpeedAI 上 Alibaba 更多模型背后的团队。

阿里巴巴通义实验室推出了 Wan 系列视频模型和 Qwen 系列大语言模型。Wan 以开放权重发布、变体覆盖广泛(文生视频、图生视频、参考生视频、视频编辑、视频延长、图像编辑、文生图)而著称,并在运动稳定性和跨多语言提示词的提示词遵循方面表现稳定。

在 WaveSpeedAI 上用 Wan 2.5 开始构建

注册即送免费体验额度。一个 API 密钥,即可使用来自 Alibaba 及其他所有提供方的 1,000 多个 AI 模型。