爱诗 PixVerse — 创建任务

POST

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

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-it2v",
  "input": {
    "media": [
      {
        "type": "image_url",
        "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp"
      }
    ],
    "prompt": "镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。"
  },
  "parameters": {
    "resolution": "720P",
    "duration": 5,
    "audio": false,
    "watermark": true
  }
}'

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

从单张图片生成最长 15 秒、最高 1080P 分辨率的视频，支持多镜头和自动音效。

模型选择

pixverse/pixverse-c1-it2v：擅长动作、特效和快速运动场景。多镜头通过提示词格式实现（镜头1：... 镜头2：...），无需 shot_type 参数。
pixverse/pixverse-v6-it2v：通用图生视频模型。多镜头需设置 shot_type: "multi"。
pixverse/pixverse-v5.6-it2v：旧版模型，建议升级至 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-it2v：针对打斗、法术特效及高速运动等动态场景
pixverse/pixverse-v6-it2v：通用场景
pixverse/pixverse-v5.6-it2v：建议升级至 v6

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

示例:pixverse/pixverse-c1-it2v

object

必填

输入的基本信息，如提示词、媒体素材等。

显示子属性

object[]

必填

媒体素材列表，用于指定视频生成所需的图像。图像数量推荐为 1 张，若传入多张图像系统将默认采用最后一个。

显示子属性

enum<string>

必填

媒体素材类型。固定值为 image_url（图像 URL）。

可选值：image_url

string

必填

图像文件的 URL 地址，必须为公网可访问的 URL。支持 HTTP 或 HTTPS 协议。格式支持 JPG、PNG、WEBP，分辨率不超过 10000 像素，文件大小不超过 20MB。

string

文本提示词，用来描述生成视频中期望包含的元素和视觉特点。支持中英文，每个汉字/字母占一个字符。pixverse-c1-it2v 和 pixverse-v6-it2v 不超过 5000 个字符，pixverse-v5.6-it2v 不超过 2048 个字符，超过部分会自动截断。

示例:镜头从海龟下方缓缓上移，海龟悠然游动，腹部细节清晰可见。

object

视频处理参数，如设置视频分辨率、设置视频时长、开启音频生成、添加水印等。

显示子属性

enum<string>

必填

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

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

integer

必填

生成视频的时长，单位为秒。duration 直接影响费用，按秒计费。

pixverse-c1-it2v 和 pixverse-v6-it2v：取值范围 [1, 15] 之间的整数
pixverse-v5.6-it2v：360P/540P/720P 时取值为 5、8、10；1080P 时取值为 5、8

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

enum<boolean>

默认值false

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

可选值：false,true

enum<string>

默认值"single"

指定生成视频的镜头类型，控制视频是由一个连续镜头还是多镜头组成。仅 pixverse-v6-it2v 模型支持。

single：默认值，生成单镜头视频
multi：多镜头，系统会进行智能分镜

使用建议：prompt 参数优先级高于 shot_type。若想稳定输出单镜头，设置 shot_type="single" 并在 prompt 中描述单镜头场景；若想稳定输出多镜头，设置 shot_type="multi" 并在 prompt 中描述多镜头场景。

可选值：single,multi

enum<boolean>

默认值false

是否添加水印标识，水印位于视频右下角，文案固定为"AI生成"。

可选值：false,true

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

​模型选择

鉴权

Header 参数

请求体

响应

模型选择