视频扩幅 Video Expand

视频扩幅根据目标画幅补充原视频边界之外的内容。可使用 PixVerse 已生成的视频，也可使用自行上传的视频。

源视频信息

视频来源

参数	说明
`source_video_id`	PixVerse 已生成视频的 `video_id`。视频须已生成成功、可访问且未删除。
`video_media_id`	上传资源接口返回的视频 `media_id`，素材类型须为 `video`。

两种 ID 必须且只能提供一个，且值须为正整数；未使用的字段直接省略。

视频规则

每次处理一个视频，最长 30 秒、最大 50 MB。

支持 MP4、MOV、WebM。

请求参数

参数	类型	是否必填	说明
`source_video_id`	integer (int64)	二选一	PixVerse 已生成视频的 ID；与 `video_media_id` 必须且只能提供一个。
`video_media_id`	integer (int64)	二选一	上传视频的 `media_id`；与 `source_video_id` 必须且只能提供一个。
`aspect_ratio`	string	是	目标画幅比例：`16:9`、`9:16`、`21:9`、`4:3`、`3:4`、`1:1`、自定义比例。
`quality`	string	是	输出清晰度：`720p`、`1080p`。

最小请求示例

{
  "source_video_id": 123456,
  "aspect_ratio": "9:16",
  "quality": "720p"
}

使用上传视频时，将 source_video_id 替换为 video_media_id，值填写上传接口返回的 media_id。

响应字段

字段	类型	说明
`ErrCode`	integer	业务错误码。`0` 表示请求成功，非 `0` 表示请求失败。
`ErrMsg`	string	响应信息。受理成功时为 `Success`，失败时提供简要错误信息。
`Resp`	object / null	受理成功时返回任务信息；失败响应中可为 `null`。
`Resp.video_id`	integer (int64)	本次扩幅创建的新视频任务 ID，用于查询生成状态和获取结果。
`Resp.credits`	integer	本次扩幅任务的点数。
`Error`	object	可选的补充错误详情，包含 `Type`（错误类型）、`Message`（具体原因和处理建议）和 `Param`（相关补充信息）。

Error.Param 字段说明

Error.Param 是公共错误补充信息对象，按具体错误返回相关字段；没有可用信息时为 {}。以下字段均可选，也可能增加新的字段，客户端应允许未知字段。

字段	类型	说明
`Fields`	string[]	与错误相关的请求字段。
`AllowedValues`	string[]	相关字段在本次请求中允许使用的值；无法确定时省略。具体值随字段及接口要求变化，不是固定枚举。
`RequiredField`	string	应改用的字段，适用于模板输入相关错误。
`RequiredCount`	integer	模板要求的素材数量，适用于模板输入相关错误。
`Moderation`	object	可用时返回的素材审核补充信息。
`Moderation.LabelName`	string	可用时提供的审核说明；多个说明以换行分隔，不要匹配说明文本做程序分支。

此处列出公共结构，不表示扩幅接口会返回全部字段。RequiredField、RequiredCount 是模板相关字段；审核补充信息是否返回取决于具体错误，不保证任务创建响应中包含 Moderation。

请求成功不代表扩幅已完成。请使用返回的新 video_id 查询任务状态。

响应示例

受理成功

以下以 5 秒源视频、720p 为例，点数为 60。ID 仅作示意。

{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "video_id": 123457,
    "credits": 60
  }
}

请求失败

以下展示 quality 不符合接口要求时的完整响应示例：

{
  "ErrCode": 400017,
  "ErrMsg": "Invalid parameter",
  "Resp": null,
  "Error": {
    "Type": "FIELD_VALUE_INVALID",
    "Message": "Field 'quality' has an unsupported value. Check the allowed values and format for this endpoint.",
    "Param": {
      "AllowedValues": [
        "720p",
        "1080p"
      ],
      "Fields": [
        "quality"
      ]
    }
  }
}

下一步

调用「查询任务状态」接口 GET /openapi/v2/video/result/{video_id}，使用本次扩幅返回的新 video_id 查询生成进度，并在任务成功后获取视频 URL。

源视频信息#

视频来源#

视频规则#

请求参数#

最小请求示例#

响应字段#

Error.Param 字段说明#

响应示例#

受理成功#

请求失败#

下一步#

请求参数

返回响应

源视频信息

视频来源

视频规则

请求参数

最小请求示例

响应字段

Error.Param 字段说明

响应示例

受理成功

请求失败

下一步