跳转到主要内容
千问云 home page
开放平台文档
PixVerse

爱诗 PixVerse — 创建任务

提交爱诗 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-t2v",
  "input": {
    "prompt": "下着雨，赛博城市里，一只浣熊在栏杆上行走。突然他眼睛发出蓝光，变身成一架高科技无人机，快速飞离画面。"
  },
  "parameters": {
    "size": "1280*720",
    "duration": 5,
    "watermark": true
  }
}'
{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}
请先获取 API Key 并配置为环境变量。

模型概览

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

分辨率与时长

c1 / v6 模型
档位支持分辨率时长
360P640*360、640*480、640*640、480*640、360*640、640*432、432*640、640*2881–15 秒
540P1024*576、1024*768、1024*1024、768*1024、576*1024、1024*688、688*1024、1024*4481–15 秒
720P1280*720、1108*832、960*960、832*1108、720*1280、1200*800、800*1200、1280*5601–15 秒
1080P1920*1080、1664*1248、1440*1440、1248*1664、1080*1920、1776*1184、1184*1776、1920*8321–15 秒
v5.6 模型
档位支持分辨率时长
360P640*360、640*480、640*640、480*640、360*6405、8、10 秒
540P1024*576、1024*768、1024*1024、768*1024、576*10245、8、10 秒
720P1280*720、1280*960、1280*1280、960*1280、720*12805、8、10 秒
1080P1808*1018、1808*1356、1808*1808、1356*1808、1018*18085、8 秒

多镜头模式

c1 模型：在 input.prompt 中以自然语言描述多个镜头（如 镜头1：模特向前漫步；镜头2：中景展示面料质感；镜头3：远景捕捉裙摆动态），模型根据提示词内容自动生成对应镜头运动。 v6 模型：将 parameters.shot_type 设为 multi，模型自动生成多镜头组合视频；设为 single（默认）则输出单一连续镜头。

使用流程

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

错误码

大模型服务通用状态码请查阅错误码。

鉴权

​
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-t2v：针对打斗、法术特效及高速运动等动态场景
  • pixverse/pixverse-v6-t2v：通用场景
  • pixverse/pixverse-v5.6-t2v：建议升级至 v6
可选值：pixverse/pixverse-c1-t2v,pixverse/pixverse-v6-t2v,pixverse/pixverse-v5.6-t2v
示例:pixverse/pixverse-c1-t2v
​
object
必填

输入的基本信息，如提示词等。

​
object
必填

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

响应

200-application/json
​
string

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

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

任务输出信息。