跳转到主要内容
千问云 home page
开放平台文档
首帧（DashScope V1）

爱诗 PixVerse — 创建任务

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

POST
/services/aigc/video-generation/video-synthesis
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
  --header 'X-DashScope-Async: enable' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "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": false
    }
  }'
{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}
请先获取 API Key 并配置为环境变量。

模型概览

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

输入限制

首帧图像要求
限制项要求
格式JPG、PNG、WEBP
最长边不超过 10000 像素
文件大小不超过 20 MB
URL 类型HTTP/HTTPS 公网可访问地址
分辨率与时长
模型支持分辨率支持时长
pixverse/pixverse-c1-it2v360P、540P、720P、1080P1–15 秒
pixverse/pixverse-v6-it2v360P、540P、720P、1080P1–15 秒
pixverse/pixverse-v5.6-it2v360P、540P、720P5、8、10 秒

多镜头模式

c1 模型：在 input.prompt 中以 [shot_type] 格式指定镜头类型（如 [close-up] 人物特写），模型会根据提示词内容自动生成对应镜头运动。 v6 模型：将 parameters.shot_type 设为 multi，模型将自动生成多镜头组合视频；设为 single（默认）则输出单一连续镜头。

使用流程

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

错误码

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

鉴权

​
string
header
必填

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

Header 参数

​
enum<string>
必填

固定值 enable，启用异步模式。

可选值：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
必填

视频生成的输入内容。

万相2.7

Wan 2.7 — 查询结果

查询 Wan 2.7 图像任务状态

GET
/tasks/{task_id}
cURL - Query task result
# 将 {task_id} 替换为上一次 API 调用返回的 task_id 值。
# task_id 在 24 小时内有效。
curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "43d9e959-25bc-4dc7-9888-xxxxxx",
  "output": {
    "task_id": "858cad55-4bdc-4ba3-ae6c-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-31 19:57:58.840",
    "scheduled_time": "2026-03-31 19:57:58.877",
    "end_time": "2026-03-31 19:58:11.563",
    "finished": true,
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "role": "assistant",
          "content": [
            {
              "image": "https://dashscope-result.oss-cn-shanghai.aliyuncs.com/1xxx.png?Expires=xxx",
              "type": "image"
            }
          ]
        }
      }
    ]
  },
  "usage": {
    "size": "2985*1405",
    "total_tokens": 18792,
    "image_count": 1,
    "output_tokens": 2,
    "input_tokens": 18790
  }
}
查询任务状态和结果。

轮询策略

使用返回的 task_id 轮询此接口，建议每 5-10 秒轮询一次。

注意事项

  • URL 有效期：图片 URL 在 24 小时后过期，请及时下载。
  • 任务状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。
  • 其他状态：CANCELED（任务已取消）、UNKNOWN（任务 ID 无效或已过期）。
  • task_id 有效期：task_id 有效期为 24 小时，过期后无法查询状态和结果。
  • 避免重复提交：请通过轮询获取结果，不要重复提交请求。

鉴权

​
string
header
必填

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

路径参数

​
string
必填

异步任务创建接口返回的任务标识符。

响应

200-application/json
​
string

唯一请求标识符。

示例:43d9e959-25bc-4dc7-9888-xxxxxx
​
object
​
string

视频内容描述，支持中英文。c1/v6 模型最长 5000 字符，v5.6 模型最长 2048 字符（超出自动截断）。

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

视频生成参数。

响应

200-application/json
​
string

本次请求的唯一 ID，用于排查问题。

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