跳转到主要内容
首帧

爱诗 PixVerse — 创建任务

基于首帧图片提交爱诗 PixVerse 图生视频异步任务

POST
/services/aigc/video-generation/video-synthesis
curl --location 'https://maas.qianwenaiapi.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"
  }
}

模型概览

模型名说明
pixverse/pixverse-c1-it2v旗舰动作与特效模型,适合动态镜头、打光等复杂运动场景;首帧模式支持通过提示词格式指定镜头类型
pixverse/pixverse-v6-it2v通用高质量模型,适合人像、风景等多种主题;通过 shot_type 参数开启多镜头模式
pixverse/pixverse-v5.6-it2v旧版模型,最大分辨率 1080P,支持时长 5、8、10 秒(1080P 仅支持 5、8 秒)

输入限制

首帧图像要求
限制项要求
格式JPG、PNG、WEBP
边长宽、高均不超过 10000 像素
文件大小不超过 20 MB
URL 类型HTTP/HTTPS 公网可访问地址
数量推荐传入 1 张;传入多张时系统只采用最后一张
媒体对象的 type 固定为 image_url。提示词支持中英文,UTF-8 编码,超出长度会自动截断:c1、v6 模型不超过 5000 字符,v5.6 模型不超过 2048 字符。 分辨率与时长
模型支持分辨率支持时长
pixverse/pixverse-c1-it2v360P、540P、720P、1080P1–15 秒
pixverse/pixverse-v6-it2v360P、540P、720P、1080P1–15 秒
pixverse/pixverse-v5.6-it2v360P、540P、720P、1080P360P/540P/720P: 5、8、10 秒;1080P: 5、8 秒

多镜头模式

c1 模型:在 input.prompt 中描述多镜头场景即可,模型会根据提示词内容自动生成对应镜头运动。不支持设置 shot_type 参数。 v6 模型:将 parameters.shot_type 设为 multi,模型将自动生成多镜头组合视频;设为 single(默认)则输出单一连续镜头。

使用流程

  1. 调用本接口提交图生视频任务,获取 task_id。
  2. 调用查询结果接口,使用 task_id 轮询任务状态,直到获取生成的视频 URL。

错误码

大模型服务通用状态码请查阅错误码。
  • Python SDK
import dashscope
import os
from dashscope.v2 import DashScopeError

# 若没有配置环境变量,请用千问AI平台API Key将下行替换为:api_key="sk-xxx"
# 获取API Key:https://platform.qianwenai.com/home/api-keys
client = dashscope.Client(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://maas.qianwenaiapi.com/api/v1",
)

media = [{'type': 'image_url', 'url': 'https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260121/zlpocv/wan-i2v-haigui.webp'}]

def sample_async_call():
    # 异步提交视频生成任务
    try:
        # audio 不在具名签名内,经 parameters 透传
        job = client.videos.jobs.create(
            model='pixverse/pixverse-c1-it2v',
            media=media,
            prompt='镜头从海龟下方缓缓上移,海龟悠然游动,腹部细节清晰可见。',
            resolution='720P',
            duration=5,
            watermark=True,
            parameters={'audio': False})
        print(job)
        print("task_id: %s" % job.task_id)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")
        return

    # 查询任务状态
    try:
        snapshot = client.videos.jobs.fetch(job.task_id)
        print(snapshot.status)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

    # 等待任务完成(指数退避轮询,默认总预算24小时)
    try:
        done = client.videos.jobs.wait(job)
        print(done)
        print(done.video_url)
    except DashScopeError as e:
        print(f"HTTP返回码:{e.status_code}")
        print(f"错误码:{e.code}")
        print(f"错误信息:{e.message}")
        print("请参考文档:/api-reference/preparation/error-messages")

if __name__ == '__main__':
    sample_async_call()

鉴权

string
header
必填

千问AI平台 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

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

响应

200-application/json
string

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

4909100c-7b5a-9f92-bfe5-xxxxxx
object

任务输出信息。