跳转到主要内容
POST
/
v3
/
async
/
wan-i2v
Wan 2.1 图生视频
curl --request POST \
  --url https://api.ppio.com/v3/async/wan-i2v \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "prompt": "<string>",
  "image_url": "<string>",
  "negative_prompt": "<string>",
  "width": 123,
  "height": 123,
  "loras": [
    {
      "path": "<string>",
      "scale": 123
    }
  ],
  "seed": 123,
  "steps": 123,
  "guidance_scale": 123,
  "flow_shift": 123,
  "enable_safety_checker": true,
  "fast_mode": true,
  "watermark": true
}
'
{
  "task_id": "<string>"
}
Wan 2.1 14B 图生视频模型的加速推理，这是一套全面且开放的视频基础模型套件，推动了视频生成的边界。默认情况下，API 将生成 5 秒的视频。
本模型服务仅针对已完成 PPIO派欧云 平台企业认证的用户开放。具体请参见实名认证。
这是一个异步API，只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索视频生成结果。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
prompt
string
必填
指导生成所需的提示文本。取值范围：[1, 2000]。
​
image_url
string
必填
用于视频生成的图像 URL。
​
negative_prompt
string
负面提示指示模型避免生成哪些元素。取值范围：[0, 2000]。
​
width
integer
输出视频的宽度。枚举值：480、720、832、1280。默认：832。如果未指定宽度或高度，宽度和高度将被强制设置为 832 和 480。
​
height
integer
输出视频的高度。支持：
  • (480p) 宽度为 480 时高度设置为 832
  • (480p) 宽度为 832 时高度设置为 480
  • (720p) 宽度为 720 时高度设置为 1280
  • (720p) 宽度为 1280 时高度设置为 720
默认：480。如果未指定宽度或高度，宽度和高度将被强制设置为 832 和 480。
输出视频将保持输入图像的宽高比，宽度 x 高度 设置仅决定输出视频的清晰度。例如，720p 视频将比 480p 视频更清晰。
​
loras
object[]
应用于视频生成的 LoRA 模型。支持最多指定 3 个 LoRA 模型。
​
seed
integer
随机数种子，稳定扩散产生噪声的数字，取值范围：[-1, 9999999999]。默认值为 -1。
​
steps
integer
迭代步数，图片创建过程的迭代数，取值范围：[1, 40]。默认：30。
​
guidance_scale
float
引导缩放参数控制生成内容对提示的跟随程度。取值范围：[0, 10]。默认：5.0。
​
flow_shift
float
flow_shift 参数主要影响视频中物体运动的速度和幅度。更高的值产生更明显和更快的运动，而较低的值使运动更慢更细微。取值范围：[1, 10]。默认：5.0。
​
enable_safety_checker
boolean
enable_safety_checker 参数控制是否对生成的内容应用安全过滤器。启用时，它有助于从视频输出中过滤掉潜在的有害或不当内容。默认：true。
​
fast_mode
boolean
是否启用快速模式，将更快地生成视频但可能降低质量和价格。默认：false。
​
watermark
boolean
默认值:false
为生成的视频添加水印。
  • false：不添加水印。
  • true：在视频添加文字的水印，标识由人工智能生成合成。

​
响应

​
task_id
string
必填
异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果

​
示例

以下是如何使用 Wan 2.1 图生视频 API 的示例。
  1. 通过向 Wan 2.1 图生视频 API 发送 POST 请求生成 task_id。
请求： 
curl --location 'https://api.ppio.com/v3/async/wan-i2v' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data '{
    "image_url": "https://pub-f964a1c641c04024bce400ad128c8cd6.r2.dev/wan-i2v-input-image.jpg",
    "height": 1280,
    "width": 720,
    "steps": 25,
    "seed": -1,
    "prompt": "A cute panda is walking in the grassland slowly."
}'
响应： 
{
    "task_id": "{返回的任务 ID}"
}
  1. 使用 task_id 获取输出视频。
2xx 范围内的 HTTP 状态码表示请求已被成功接受，而 5xx 范围内的状态码表示内部服务器错误。 您可以在响应的 videos 中获取视频 URL。 请求： 
curl --location --request GET 'https://api.ppio.com/v3/async/task-result?task_id={返回的任务 ID}' \
--header 'Authorization: Bearer {{API Key}}'
响应： 
{
    "task": {
        "task_id": "{返回的任务 ID}",
        "task_type": "WAN_IMG_TO_VIDEO",
        "status": "TASK_STATUS_SUCCEED",
        "reason": "",
        "eta": 0,
        "progress_percent": 100
    },
    "images": [],
    "videos": [
        {
            "video_url": "{生成视频的 URL}",
            "video_url_ttl": "3600",
            "video_type": "mp4"
        }
    ]
}
视频文件：