万相3.0-视频生成

POST /api/v1/services/aigc/video-generation/video-synthesis — 全能参考生视频（文生/图生/参考生/文件生视频一体）

万相 3.0 是全能参考视频生成模型（All-in-One）：一个模型统一支持文生视频、图生视频（首帧/首尾帧）、参考生视频、文件/网页生视频。最长 30 秒，输出帧率 30fps。

支持的模型

模型	说明
`wan3.0-video`	标准版
`wan3.0-video-prime`	高速版——能力对齐标准版，端到端速度显著提升

创建任务

POST/api/v1/services/aigc/video-generation/video-synthesis

curl https://api.modelsite.ai/api/v1/services/aigc/video-generation/video-synthesis \
  -H "Authorization: Bearer $MODELSITE_API_KEY" -H "Content-Type: application/json" \
  -d '{
    "model": "wan3.0-video",
    "input": { "prompt": "航拍云海之上的雪山日出，光线逐渐染红峰顶" },
    "parameters": { "resolution": "1080P", "ratio": "adaptive", "duration": -1 }
  }'

请求体

字段	类型	说明
`model`	string（必填）	`wan3.0-video` 或 `wan3.0-video-prime`
`input.prompt`	string	提示词，≤20000 字符。与 `media` 必填其一。全能参考模式下用「图1」「视频1」「音频1」指代 media 中对应顺序的素材（图和视频分别计数）
`input.media`	array	素材数组，见下表
`parameters`	object（可选）	见下表

media 元素类型

type	上限	用途
`first_frame` / `last_frame`	各 1 张	首帧 / 尾帧硬约束。与下面所有 reference/file/link 类型互斥，不能混用
`reference_image`	≤10 张	参考图像
`reference_video`	≤5 段（总时长 ≤15s）	参考视频
`reference_audio`	≤5 段（总时长 ≤15s）	参考音频
`file`	1 个	文档（pdf/docx/pptx 等，≤100MB，≤50 页）。与 `link` 二选一
`link`	1 个	公开网页链接。与 `file` 二选一

parameters 参数

参数	类型	说明
`resolution`	string	`480P` / `720P` / `1080P`（默认）。可售档位以价格配置为准
`ratio`	string	`adaptive`（默认，自适应）/ `21:9` / `16:9` / `4:3` / `1:1` / `3:4` / `9:16`
`duration`	integer	`[2, 30]` 的整数；传 `-1` 为智能时长模式（模型自决）；有视频输入时「输入时长 + 输出时长」≤30
`audio`	boolean	输出是否含音轨，默认 `true`；开关声音价格相同
`seed`	integer	`[0, 2147483647]`
`prompt_extend`	boolean	默认 `true`。传 `file` / `link` 时必须保持 `true`，显式传 `false` 会被拒绝
`watermark`	boolean	默认 `false`

轮询与结果

GET/api/v1/tasks/{task_id}

curl "https://api.modelsite.ai/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $MODELSITE_API_KEY"

响应字段

字段	说明
`output.task_id`	任务 ID（与创建时返回的一致）
`output.task_status`	`PENDING` 排队 / `RUNNING` 处理中 / `SUCCEEDED` 成功 / `FAILED` 失败
`output.video_url`	生成视频的 URL，仅 `SUCCEEDED` 时返回，尽快下载转存
`output.code` / `output.message`	仅失败时返回，失败原因
`usage`	用量统计（时长、分辨率档位等），仅成功时计数
`request_id`	请求唯一标识，排查问题时请提供

状态流转：PENDING → RUNNING → SUCCEEDED / FAILED。

计费

按实际生成时长（秒）计费；duration: -1 时由模型决定实际时长，计费以轮询响应 usage.duration 为准；任务失败不计费。单价见模型页。

错误处理

创建阶段错误返回 {"code": "...", "message": "..."}；任务内失败看轮询的 output.code / output.message。通用错误码见错误处理。

万相3.0-视频生成

支持的模型

创建任务

轮询与结果

计费

错误处理

本页内容