万相2.7-图生视频

POST /api/v1/services/aigc/video-generation/video-synthesis — wan2.7 图生视频（首帧 / 首尾帧 / 续写）

万相 2.7 图生视频模型，支持多模态输入，可完成三大任务：首帧生视频、首尾帧生视频、视频续写。

支持的模型

模型	说明
`wan2.7-i2v`	万相 2.7 图生视频

创建任务

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": "wan2.7-i2v",
    "input": {
      "prompt": "一只猫从草地上起身，向阳光处走去",
      "media": [{ "type": "first_frame", "url": "https://example.com/cat.png" }]
    },
    "parameters": { "resolution": "720P", "duration": 5 }
  }'

请求体

字段	类型	说明
`model`	string（必填）	`wan2.7-i2v`
`input.prompt`	string（可选）	引导描述，≤5000 字符。素材已表达意图时可省略
`input.negative_prompt`	string（可选）	反向提示词，≤500 字符（在 `input` 里，不在 `parameters` 里）
`input.media`	array（必填）	素材列表，见下方组合规则
`parameters`	object（可选）	见下表

素材组合（六种合法组合，其余组合报错）

任务	media 组合
首帧生视频	`first_frame`
首帧 + 音频	`first_frame` + `driving_audio`
首尾帧生视频	`first_frame` + `last_frame`
首尾帧 + 音频	`first_frame` + `last_frame` + `driving_audio`
视频续写	`first_clip`
续写 + 尾帧	`first_clip` + `last_frame`

每种 type 在数组中最多出现 1 次。素材限制：图像 JPEG/JPG/PNG/BMP/WEBP，宽高 [240, 8000]px，≤20MB；驱动音频 wav/mp3，2~~30s，≤15MB；首段视频 mp4/mov，2~~10s，≤100MB。

parameters 参数

参数	类型	说明
`resolution`	string	`720P` / `1080P`（默认）。可售档位以价格配置为准。输出宽高比跟随输入素材
`duration`	integer	`[2, 15]` 的整数，默认 5。续写场景为输出总时长上限（输入 3 秒 + duration 15 → 输出 15 秒，按 15 秒计费）
`prompt_extend`	boolean	默认 `true`
`watermark`	boolean	默认 `false`（"AI生成" 角标）
`seed`	integer	`[0, 2147483647]`

图生视频没有 ratio 参数——输出宽高比由输入素材决定，传了会报 InvalidParameter。

轮询与结果

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。

计费

按实际生成时长（秒）计费；续写按输出总时长计费；任务失败不计费。单价见模型页。

错误处理

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

万相2.7-图生视频

支持的模型

创建任务

轮询与结果

计费

错误处理

本页内容