wan2.7-i2v API

使用精确模型 ID wan2.7-i2v。请求中的模型名必须与本页完全一致。

示例输出wan2.7-i2vPOST /v1/videos5.0s

请求参数：duration=5resolution=1080pratio=16:9输入图片

提示词：One continuous take, no cuts. The ribbon of film keeps unwinding and speeds up until every frame is lit, tightening into a neon helix that lifts off the deck and climbs past the parapet into the dusk sky, the woman in the cobalt coat turning to follow it up. The camera starts low behind her, is pushed back as the helix rises, then cranes up over the parapet and looks along the coil toward the city. One hard magenta key stays raking across the deck. Real weight and inertia, paper and emulsion catching the light, no text.

生成该示例的请求（输入媒体地址已替换）

{
  "model": "wan2.7-i2v",
  "prompt": "One continuous take, no cuts. The ribbon of film keeps unwinding and speeds up until every frame is lit, tightening into a neon helix that lifts off the deck and climbs past the parapet into the dusk sky, the woman in the cobalt coat turning to follow it up. The camera starts low behind her, is pushed back as the helix rises, then cranes up over the parapet and looks along the coil toward the city. One hard magenta key stays raking across the deck. Real weight and inertia, paper and emulsion catching the light, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9",
  "image": "https://example.com/input-image.png"
}

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev/v1 发送请求。网关入口为 POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

创建任务

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-i2v",
    "input": {"prompt": "镜头向前推进，灯笼随着音乐逐渐亮起。", "media": [{"type": "first_frame", "url": "https://example.com/first-frame.png"}]},
    "parameters": {"resolution": "1080P", "duration": 5, "prompt_extend": false, "watermark": false}
  }'

任务查询与下载

提交成功后保存任务 ID。使用 GET /v1/videos/{task_id} 轮询，完成后使用 GET /v1/videos/{task_id}/content 下载；结果地址可能过期，应及时转存。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

请求要点

Wan 通常使用 input 与 parameters；帧引导和 reference media 不能混用。

请求参数

Wan2.7 I2V 使用 input.prompt 与 input.media。首帧、尾帧、驱动音频和首段视频必须遵循官方允许的媒体组合。

字段	必填	说明
model	是	wan2.7-i2v
input.prompt	是	运动与场景描述
input.media[]	是	first_frame、last_frame、driving_audio 或 first_clip
parameters.resolution	否	720P / 1080P（默认 1080P）
parameters.duration	否	总时长；续写时包含输入片段
parameters.prompt_extend	否	该独立模型按模型契约设为 false
parameters.watermark	否	是否添加水印

输入与输出限制

I2V 的 media 组合必须是 first_frame、first_frame + last_frame、first_frame + driving_audio，或 first_clip（可按接口规则附加尾帧）。每种媒体类型最多出现一次；输出为 720P/1080P。

官方工作流示例

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-i2v",
    "input": {"prompt": "镜头从第一帧推进到最后一帧", "media": [
      {"type": "first_frame", "url": "https://example.com/first.png"},
      {"type": "last_frame", "url": "https://example.com/last.png"}
    ]},
    "parameters": {"resolution": "1080P", "duration": 8, "prompt_extend": false}
  }'

错误与失败任务

参数不符合模型契约时，创建接口会返回带 request ID 的 4xx。异步任务也可能在创建成功后进入 failed；轮询响应中的 error_code 和 error_message 才是该任务的最终原因。不要把同一请求改成另一种 JSON 结构重试。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按视频秒计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

注意

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。

变体

模型 ID	差异
wan2.7-i2v	本页说明的模型。