PixVerse — 创建任务

POST

/services/aigc/video-generation/video-synthesis

cURL

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "pixverse/pixverse-c1-kf2v",
  "input": {
    "media": [
      {"type": "first_frame", "url": "https://wanx.alicdn.com/material/20250318/first_frame.png"},
      {"type": "last_frame", "url": "https://wanx.alicdn.com/material/20250318/last_frame.png"}
    ],
    "prompt": "一只小猫从窗台向下跳跃，轻盈地落在沙发上，然后好奇地环顾四周。"
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5,
    "watermark": true
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

根据首帧图像、尾帧图像和文本提示词，生成平滑过渡的视频。

模型选择

pixverse/pixverse-c1-kf2v：擅长打斗、法术特效和高速运动场景。
pixverse/pixverse-v6-kf2v：通用模型。
pixverse/pixverse-v5.6-kf2v：旧版模型，建议升级至 v6。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

异步处理配置参数。HTTP请求只支持异步，必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。可选值：pixverse/pixverse-c1-kf2v（针对打斗、法术特效及高速运动等动态场景）、pixverse/pixverse-v6-kf2v（通用场景）、pixverse/pixverse-v5.6-kf2v（建议升级至v6）。

可选值：pixverse/pixverse-c1-kf2v,pixverse/pixverse-v6-kf2v,pixverse/pixverse-v5.6-kf2v

示例:pixverse/pixverse-c1-kf2v

object

必填

输入的基本信息，包含首帧、尾帧图像和提示词。

显示子属性

string

必填

文本提示词。用来描述首帧到尾帧之间的变化过程。支持中英文，每个汉字/字母占一个字符，字符编码为UTF-8，超过部分会自动截断。pixverse/pixverse-c1-kf2v 和 pixverse/pixverse-v6-kf2v：不超过5000个字符；pixverse/pixverse-v5.6-kf2v：不超过2048个字符。

示例:一只小猫从窗台向下跳跃，轻盈地落在沙发上，然后好奇地环顾四周。

取值范围：length <= 5000

object[]

必填

媒体资源列表，包含首帧和尾帧图像。数组的每个元素为一个媒体对象，包含 type 与 url 字段。media数组中需要包含两个对象，分别设置type为first_frame（首帧）和last_frame（尾帧），顺序不影响结果，系统会根据type字段自动识别。首帧和尾帧图像的分辨率不需要一致，系统会自动处理，输出视频的宽高比将以首帧图像为基准（近似）。

示例:

[
  {
    "type": "first_frame",
    "url": "https://wanx.alicdn.com/material/20250318/first_frame.png"
  },
  {
    "type": "last_frame",
    "url": "https://wanx.alicdn.com/material/20250318/last_frame.png"
  }
]

取值范围：items: 2–2

显示子属性

enum<string>

必填

媒体类型。first_frame：首帧图像，有且仅有1张。last_frame：尾帧图像，有且仅有1张。

可选值：first_frame,last_frame

string

必填

图像的公网可访问URL，支持 HTTP 或 HTTPS 协议。示例值：https://xxx/xxx.png。图像限制：格式为JPG、PNG、WEBP；宽度和高度均不超过10000像素；文件大小不超过20MB。

示例:https://wanx.alicdn.com/material/20250318/first_frame.png

object

视频生成参数。如设置视频分辨率、时长、是否生成音频等。

显示子属性

enum<string>

必填

生成视频的分辨率。可选值：360P、540P、720P、1080P。resolution直接影响费用，请在调用前确认模型价格。

可选值：360P,540P,720P,1080P

示例:720P

integer

必填

生成视频的时长，单位为秒。pixverse/pixverse-c1-kf2v 和 pixverse/pixverse-v6-kf2v：取值范围为[1, 15]之间的整数。pixverse/pixverse-v5.6-kf2v：当resolution为360P/540P/720P时取值为5、8、10；当resolution为1080P时取值为5、8。duration直接影响费用，请在调用前确认模型价格。

示例:5

取值范围：1 <= x <= 15

boolean

默认值false

是否生成有声视频。开启后模型将根据视频内容自动生成匹配的背景音乐或音效。默认值：false（输出无声视频）。audio直接影响费用，请在调用前确认模型价格。

boolean

默认值false

是否添加水印标识，水印位于视频右下角，文案固定为"AI生成"。默认值：false（不添加水印）。

integer

随机数种子，取值范围为 [0, 2147483647]。未指定时，系统自动生成随机种子。若需提升生成结果的可复现性，建议固定seed值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致。

取值范围：0 <= x <= 2147483647

响应

200-application/json

string

请求唯一标识。可用于请求明细溯源和问题排查。

示例:4909100c-7b5a-9f92-bfe5-xxxxxx

object

显示子属性

string

任务ID。用于查询任务状态与结果，有效期24小时。

示例:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

任务状态。初始状态通常为 PENDING。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

​模型选择

鉴权

Header 参数

请求体

响应

模型选择