Wan 3.0 - 生成视频

接口

POST /videos/generations

完整 URL: https://modelfold.ai/v1/videos/generations

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

模型参数直接放在 JSON 请求体中，不要套 input。请求等待生成完成后返回 data[].url；支持的媒体模型也可使用 异步创建、轮询及回调。示例素材地址须替换为自己的公开可访问文件。计费及错误说明见 API 网关。

Wan 3.0 生成视频参数。

请求参数

请求体 (application/json)

参数	类型	必填	说明
model	string	是	wan/3-0-video 是标准模型。用于生成视频的模型名称。必填字段。 - 此端点必须为 wan/3-0-video 可选值：wan/3-0-video。 示例：wan/3-0-video。
prompt	string	是	本站网关要求传入 prompt，最长 2000 字。文本提示词，支持中英文。最多 20000 字符。文生视频必填；其他模式建议与媒体一起传。参考模式用 Image1/Video1/Audio1 引用素材。 maxLength: 2000. 示例：月光下一只小猫在屋顶奔跑，远处霓虹闪烁，电影质感，运镜流畅。。
first_frame_url	string	否	首帧图 URL，最多 1 张，严格作为视频第一帧。用于首帧生视频 / 首尾帧生视频。不可与 reference_*_urls 同传。 格式：JPEG/JPG、PNG（不支持透明通道）、BMP、WEBP；单边 [240, 8000] px；长宽比 ≤ 8:1；≤ 20MB。
last_frame_url	string	否	尾帧图 URL，需与 first_frame_url 一起使用，格式限制同 first_frame_url。
reference_image_urls	array<string>	否	全能参考模式的参考图，最多 10 张。按数组顺序对应 prompt 中的 Image1、Image2…。规格同 first_frame_url。不可与首帧/尾帧同传。 maxItems: 10.
reference_video_urls	array<string>	否	全能参考模式的参考视频，最多 5 段。单段 1–15s，合计 ≤ 15s。按数组顺序对应 Video1、Video2…。 格式：mp4、mov；单边 [240, 4096] px；长宽比 ≤ 8:1；单文件 ≤ 100MB。 输出侧还有一层：输入视频时长 + duration 合计不能超过 30 秒。 maxItems: 5.
reference_audio_urls	array<string>	否	全能参考模式的参考音频，最多 5 段。单段 1–15s，合计 ≤ 15s。按数组顺序对应 Audio1、Audio2…。格式：wav、mp3；≤ 15MB。参考音频可以作为唯一的媒体输入，搭配参考图或参考视频效果通常更好。 maxItems: 5.
reference_file_urls	array<string>	否	文件生视频。最多 1 个，不能与 reference_link_urls 同传，也不能与首帧/尾帧同传。 格式：docx/doc/xlsx/xls/pptx/ppt/pdf/txt/key/pages/numbers/md；≤ 100MB；pdf/docx/ppt/key/pages 等 ≤ 50 页。 maxItems: 1.
reference_link_urls	array<string>	否	链接生视频。最多 1 个公开免登录网页。不能与 reference_file_urls 同传，也不能与首帧/尾帧同传。 maxItems: 1.
resolution	string	否	输出分辨率档位。默认 1080P。 默认值："1080P"。 可选值：480P / 720P / 1080P。 示例：1080P。
aspect_ratio	string	否	输出宽高比。adaptive（默认）根据输入素材和意图自动选择。 默认值："adaptive"。 可选值：adaptive / 16:9 / 4:3 / 1:1 / 3:4 / 9:16。 示例：adaptive。
duration	integer	否	输出视频时长（秒）。默认 5。无视频输入时取 [2, 30]；有参考视频时：输入视频时长 + 输出时长合计 ≤ 30。传 -1 为智能时长，由模型决定。 本站最短 2 秒，不支持 -1。 默认值：5。 示例：5。
audio	boolean	否	输出视频是否带音轨。默认 true。 默认值：true。 示例：true。
seed	integer	否	随机种子，用于复现结果。不传则随机。 minimum: 0. maximum: 2147483647.
nsfw_checker	boolean	否	默认 false。为 false 时不额外进行内容过滤，结果由模型直接返回。

请求示例

curl -X POST "https://modelfold.ai/v1/videos/generations" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/3-0-video",
  "prompt": "月光下一只小猫在屋顶奔跑，远处霓虹闪烁，电影质感，运镜流畅。",
  "resolution": "1080P",
  "aspect_ratio": "adaptive",
  "duration": 5,
  "audio": true
}'

{
  "model": "wan/3-0-video",
  "prompt": "月光下一只小猫在屋顶奔跑，远处霓虹闪烁，电影质感，运镜流畅。",
  "resolution": "1080P",
  "aspect_ratio": "adaptive",
  "duration": 5,
  "audio": true
}

响应

200 — 生成完成。usage 返回实际计费明细；结果地址仅作结构示例。

{
  "ok": true,
  "created": 1792134000,
  "data": [
    {
      "url": "https://modelfold.ai/uploads/outputs/result.mp4"
    }
  ],
  "usage": {}
}