PixVerse

爱诗 PixVerse — 创建任务

提交 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-upscale",
    "input": {
        "media": [
            {
                "type": "video_url",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4"
            }
        ]
    },
    "parameters": {
        "seed": 12345,
        "watermark": true
    }
}'

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

传入视频文件，输出固定 4K（3840×2160）分辨率的超分辨率视频。

鉴权

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-upscale。

可选值：pixverse/pixverse-upscale

示例:pixverse/pixverse-upscale

object

必填

输入的基本信息，包括待超分的视频。

显示子属性

object[]

必填

媒体资源列表。必须包含 1 个视频元素。

显示子属性

enum<string>

必填

媒体素材类型。固定值为 video_url。

可选值：video_url

string

必填

输入视频的 URL 地址，必须为公网可访问的 URL，支持 HTTP 或 HTTPS 协议。视频限制：格式为 MP4、MOV、WebM，分辨率不支持 4K 及以上，文件大小不超过 100MB，时长不超过 30 秒。

示例:https://xxx/xxx.mp4

object

视频生成参数。如设置是否添加水印、随机种子等。

显示子属性

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

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-upscale",
    "input": {
        "media": [
            {
                "type": "video_url",
                "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_input_video.mp4"
            }
        ]
    },
    "parameters": {
        "seed": 12345,
        "watermark": true
    }
}'

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