视频

Wan 2.5

Wan 2.5 API 可通过文本提示词或单张参考图生成短视频，支持可选的音频参考输入、480p/720p/1080p 分辨率、5 或 10 秒时长，并默认启用提示词扩展功能。

文本、图片或可选音频480p / 720p / 1080p5 或 10 秒提示词扩展

正在加载工作区...

接口地址

POSThttps://api.apixo.ai/api/v1/generateTask/wan-2-5-video创建任务

GEThttps://api.apixo.ai/api/v1/statusTask/wan-2-5-video?taskId={taskId}轮询状态

身份验证

正在检查 API 访问权限...

登录以领取免费积分，测试演练场，并继续进行 API 集成。

请求体

request_type

async

通过 callback_url 使用回调以实现 Webhook。

input

对象

模式、提示词、参考图、尺寸、时长和音频设置。

参数

request_type必填

类型select

使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback

callback_url有条件的

类型text

用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback

mode必填

类型select

选择文生视频或图生视频。图生视频需要且仅需要一张参考图。text-to-video · image-to-video

prompt必填

类型string

描述您想要的视频。文生视频需要提示词；图生视频可以使用提示词来引导动画。

resolution必填

类型select

选择 480p 用于低成本草稿，720p 用于均衡输出，或 1080p 用于更高质量。480p · 720p · 1080p

duration必填

类型select

Wan 2.5 支持输出 5 秒或 10 秒的视频。5 · 10

aspect_ratio有条件的

类型select

宽高比适用于文生视频，图生视频无需设置。16:9 · 9:16 · 1:1 · 4:3 · 3:4仅限 mode=text-to-video

watermark可选

类型boolean

启用后，为生成的输出添加水印。

enable_prompt_expansion可选

类型boolean

在生成前，让模型对提示词进行扩展和优化。

negative_prompt可选

类型string

描述视频中需要避免的内容。

seed可选

类型text

可选的种子值，用于可复现的生成。

参数	类型	必填项	描述
`request_type`	select	必填	使用异步模式轮询任务状态 (poll statusTask)，或使用回调模式在结果就绪时接收 webhook 通知。async · callback
`callback_url`	text	有条件的	用于接收回调通知的公开 HTTPS URL。仅限 request_type=callback
`mode`	select	必填	选择文生视频或图生视频。图生视频需要且仅需要一张参考图。text-to-video · image-to-video
`prompt`	string	必填	描述您想要的视频。文生视频需要提示词；图生视频可以使用提示词来引导动画。
`resolution`	select	必填	选择 480p 用于低成本草稿，720p 用于均衡输出，或 1080p 用于更高质量。480p · 720p · 1080p
`duration`	select	必填	Wan 2.5 支持输出 5 秒或 10 秒的视频。5 · 10
`aspect_ratio`	select	有条件的	宽高比适用于文生视频，图生视频无需设置。16:9 · 9:16 · 1:1 · 4:3 · 3:4仅限 mode=text-to-video
`watermark`	boolean	可选	启用后，为生成的输出添加水印。
`enable_prompt_expansion`	boolean	可选	在生成前，让模型对提示词进行扩展和优化。
`negative_prompt`	string	可选	描述视频中需要避免的内容。
`seed`	text	可选	可选的种子值，用于可复现的生成。

文件参数 (URL 数组)

image_urls[mode=first_and_last_frames / omni_reference]first_and_last_frames 模式必填（1-2 张图）。omni_reference 模式选填（1-9 张图）。仅限 mode=first_and_last_frames / omni_reference

audio_urls可选的 MP3 或 WAV 音频参考。Wan 2.5 仅接受一个音频 URL，最大 15 MB，推荐时长 3-30 秒。

示例 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/wan-2-5-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "text-to-video",
      "prompt": "a serene mountain landscape with moving clouds and gentle breeze",
      "resolution": "720p",
      "duration": 5,
      "aspect_ratio": "16:9",
      "negative_prompt": "low quality, blurry",
      "enable_prompt_expansion": true
    }
  }'

完整 API 文档

Wan 2.5 API 指南

用于视频生成工作流的 Wan 2.5 API

通过 APIXO 使用 Wan 2.5，您可以在 Playground 中测试提示词、查看演示、比较价格，并将相同的设置直接应用于生产环境的 API 调用。

Wan 2.5 工作流

在一个页面内构建和部署 Wan 2.5 API 工作流

此 Wan 2.5 模型主页专为希望在同一工作流中评估生成质量、比较价格、创建 API 密钥并将测试好的设置应用于生产代码的团队而设计。

Wan 2.5 提示词测试

在将请求投入生产前，使用 Wan 2.5 Playground 测试提示词、模式选项和输出设置。

Wan 2.5 演示回顾

先检查真实的或占位的视频输出，然后将相同的演示参数加载到 Playground 中以加快迭代速度。

Wan 2.5 API 对接

无需离开当前模型页面，即可从可视化测试无缝切换到 API 密钥、cURL 示例、请求 JSON 和相关文档。

Wan 2.5 定价清晰

在为生产任务选择成本模式前，请先在同一页面比较可用的定价方案。

Wan 2.5 输入控制

直接在 Playground 中调整图片、视频或运动参考，以确保测试的表单与文档化的 API 接口一致。

Wan 2.5 生产就绪

当异步轮询、回调交付、生成历史和可预测的计费对团队工作流至关重要时，请使用 APIXO。

模型概览

什么是 Wan 2.5 API？

Wan 2.5 已通过 APIXO 作为生产级 API 提供，用于视频生成。该模型页面将 Playground 测试、真实请求参数、定价和文档对接整合在一个工作流中。

请先使用此页面验证提示词和模式选项，然后将相同的设置用于 API 密钥、cURL 示例、后端集成和可重复的生成任务。

面向生产团队的 Wan 2.5 API 工作流

从 Playground 开始，选择与您的输入资产相匹配的模式。
当您需要快速获得基准配置时，可以查看输出示例并加载演示参数。
在发送大批量或更高分辨率的任务前，请检查价格。
对交互式应用使用异步轮询模式，对后端队列使用回调模式。

Wan 2.5 API 技术规格

当前 Wan 2.5 API 的功能及集成相关限制条件。

Wan 2.5 模式

文生视频与图生视频

Wan 2.5 输出

文本、图片或可选音频

Wan 2.5 参数控制

480p / 720p / 1080p / 5 或 10 秒

Wan 2.5 延迟

通常需要 40-250 秒

阿里云视频 API

Wan 2.5 核心功能

Wan 2.5 视频生成

使用 Wan 2.5 进行文生视频与图生视频工作流，其 Playground 控件与公开的 API 文档保持一致。

Wan 2.5 参考控制

在可用时上传支持的参考素材，然后在生成的 API 示例中复用相同的设置。

Wan 2.5 异步交付

通过推荐的轮询和支持回调的生产集成，为长时间运行的生成任务做好规划。

您可以用 Wan 2.5 构建什么？

Wan 2.5 产品视频

使用可复用的 API 参数，创建产品发布、电商广告、发布短片和营销活动动态素材。

Wan 2.5 社交创意

为社交渠道生成短视频，并快速迭代提示词、时长、分辨率和宽高比等设置。

Wan 2.5 故事板工作流

在投入生产预算前，使用文本提示词和参考来验证场景、镜头和动态创意。

Wan 2.5 注意事项与限制

文生视频的提示词长度必须在 1 到 1500 个字符之间。图生视频可使用可选的提示词来指导运动。
图生视频需要一个参考图 URL。
音频输入为可选，必须使用 audio_urls，且仅支持一个 15 MB 以内的 MP3 或 WAV 文件。
时长必须为 5 或 10 秒。
文生视频在所有分辨率下均支持 16:9、9:16 和 1:1 的宽高比；4:3 和 3:4 的宽高比需要 720p 或 1080p 分辨率。
负向提示词最多支持 500 个字符。

Wan 2.5 常见问题

开始构建

先在上方 Playground 进行测试，准备好集成时再查阅 API 文档。

尝试 Playground 查看 API 文档