万相视频生成

万相 2.7 和万相 3.0 都使用统一任务接口 POST /v1/video/generations。任务是异步执行的：提交后保存 task_ ID，再按异步任务工作流查询结果。

模型与输入

模型	能力	必需输入	关键限制
`wan2.7-t2v`	文生视频	`prompt`	不需要媒体。
`wan2.7-i2v`	图生视频	1 张首帧图	支持可选尾帧和驱动音频。
`wan2.7-r2v`	参考生视频	1–5 个参考媒体	可加 1 张首帧；带参考视频时，时长为 2–10 秒。
`wan2.7-videoedit`	视频编辑	1 段视频	可加最多 4 张参考图。
`wan3.0-video`、`wan3.0-video-prime`	全能参考视频生成	文本、首尾帧或参考媒体	首尾帧不能与参考媒体混用。

请求头

Header	必填	说明
`Authorization`	是	`Bearer <API_KEY>`。
`Content-Type`	是	`application/json`。

请求体字段

字段	类型	必填	说明
`model`	string	是	万相模型 ID，例如 `wan2.7-t2v`、`wan2.7-i2v`、`wan3.0-video` 或 `wan3.0-video-prime`。
`prompt`	string	是	文本提示词。
`size`	string	否	输出分辨率：`720P` 或 `1080P`。这是 AionRouter 对外字段。
`duration`	integer	条件必填	文生与图生为 2–15 秒；带参考视频的参考生为 2–10 秒；编辑不传。
`image` / `images`	string / string[]	图生时必填	首张图为首帧；`images` 的第二张图可作为尾帧。
`input_reference`	string	编辑时必填	待编辑的源视频 URL。图生时也可用作首帧。
`metadata`	object	否	传递上游参数或结构化媒体。画幅、种子、负向提示词和音频设置必须放在 `metadata.parameters`。

`metadata.input.media[]` 元素

字段	类型	必填	说明
`type`	string	是	`first_frame`、`last_frame`、`driving_audio`、`reference_image`、`reference_video`、`reference_audio`、`video`、`file` 或 `link`。
`url`	string	是	媒体的公开可访问 URL。

wan2.7-i2v 使用 first_frame、可选 last_frame 和 driving_audio。wan2.7-r2v 使用参考媒体。wan2.7-videoedit 必须使用一个 video，可添加 reference_image。万相 3.0 支持首尾帧或参考图片、视频、音频、file、link，但首尾帧不能与这些参考媒体混用。

参数规则

字段	适用范围	说明
`size`	所有模型	使用 `720P` 或 `1080P`。AionRouter 将它映射为万相分辨率参数。
`duration`	文生、图生、参考生	文生和图生支持 2–15 秒；带参考视频的参考生支持 2–10 秒。视频编辑不传此字段。
`metadata.parameters.ratio`	文生、参考生	使用 `16:9`、`9:16`、`1:1`、`4:3` 或 `3:4`。
`metadata.parameters.seed`	可选	固定随机种子，便于重复测试。
`metadata.parameters.negative_prompt`	可选	描述不希望出现在视频中的内容。
`metadata.parameters.audio_setting`	视频编辑	仅允许 `auto` 或 `origin`。

图生视频用输入图片的比例决定输出画幅，因此不要为 wan2.7-i2v 传 metadata.parameters.ratio。万相 3.0 支持 adaptive 画幅。duration: -1 仅适用于万相 3.0，由上游根据输入自动确定时长。具体可用模型和参数以列出模型与实际请求响应为准。

文生视频示例

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "prompt": "A quiet train crossing a snow-covered bridge at blue hour, wide cinematic shot",
    "size": "1080P",
    "duration": 5,
    "metadata": {
      "parameters": {
        "ratio": "16:9",
        "negative_prompt": "text overlays, shaky camera"
      }
    }
  }'

完整调用示例

所有示例使用统一任务接口。提交响应、查询响应、状态枚举和下载命令见异步任务工作流。

首尾帧图生视频

第一张 images 是首帧，第二张是尾帧。也可以改用 image 或 input_reference 只传首帧。图生视频由图片决定画幅，因此不要传 metadata.parameters.ratio。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-i2v",
    "prompt": "镜头从白天的海边小屋平滑过渡到黄昏，海浪持续拍岸，灯光逐渐亮起",
    "images": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "size": "1080P",
    "duration": 5
  }'

参考图和参考视频生视频

使用 metadata.input.media 指定媒体角色。wan2.7-r2v 可使用 1–5 个参考媒体；带参考视频时，duration 只能为 2–10 秒。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-r2v",
    "prompt": "参考角色外观和动作节奏，生成一段在花园里旋转的镜头",
    "size": "720P",
    "duration": 5,
    "metadata": {
      "parameters": { "ratio": "16:9" },
      "input": {
        "media": [
          { "type": "reference_image", "url": "https://example.com/character.jpg" },
          { "type": "reference_video", "url": "https://example.com/motion.mp4" }
        ]
      }
    }
  }'

视频编辑

wan2.7-videoedit 必须传 1 段源视频。使用 images 传可选参考图，最多 4 张；不要传 duration。

curl -X POST "https://router.aionclaw.ai/v1/video/generations" \
  -H "Authorization: Bearer $AIONROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-videoedit",
    "prompt": "将视频改为低饱和电影胶片风格，保留人物动作和原始时长",
    "input_reference": "https://example.com/source-video.mp4",
    "images": ["https://example.com/style-reference.jpg"],
    "size": "720P",
    "metadata": {
      "parameters": { "audio_setting": "origin" }
    }
  }'

参考生只接受 first_frame、reference_image 和 reference_video。视频编辑只接受 1 个 video 和最多 4 个 reference_image。所有 URL 必须能被上游服务访问。

不要把首帧与参考媒体用于同一个 wan2.7-r2v 请求，除非你的模型配置明确支持该组合。先使用少量、清晰的参考素材验证工作流。

万相 2.7 是否可用取决于你的 API 密钥与渠道。提交前通过列出模型确认模型名。

​模型与输入

​请求头

​请求体字段

​metadata.input.media[] 元素

​参数规则

​文生视频示例

​完整调用示例

​首尾帧图生视频

​参考图和参考视频生视频

​视频编辑

模型与输入

请求头

请求体字段

`metadata.input.media[]` 元素

参数规则

文生视频示例

完整调用示例

首尾帧图生视频

参考图和参考视频生视频

视频编辑