获取视频重绘列表

本接口返回当前可用的视频重绘预设效果。

查询当前账号可用于视频重绘任务的预设效果。选择效果后，将接口返回的效果 ID 传入视频重绘接口的 restyle_id。

接口定位：辅助查询接口。本接口只返回可用重绘效果，不创建视频任务。

接入流程

获取视频重绘列表 -> 展示并选择效果 -> 取得效果 ID -> 创建视频重绘任务

使用自定义 restyle_prompt 时，可以跳过本接口。

请求 Header

Header	类型	是否必填	说明
`API-KEY`	string	是	PixVerse API Key。必须放在 Header 中。
`Ai-trace-id`	string	是	请求追踪 ID。建议每次请求生成新的 UUID。

Query 参数

参数	类型	是否必填	默认值	示例	说明
`page_num`	integer	否	`1`	`1`、`2`、`3`	页码，必须大于等于 `1`。
`page_size`	integer	否	`500`	`500`	每页数量；当前服务端未限制上限，但不建议设置不必要的超大值。

cURL 调试示例

响应字段

以下结构已通过国内环境实际请求确认：

字段	类型	说明
`ErrCode`	integer	业务错误码，`0` 表示成功。
`ErrMsg`	string	业务信息，成功时为 `Success`。
`Resp`	object	重绘效果列表响应对象。
`Resp.total`	integer	符合服务端可见条件的重绘效果实际总数，不受当前分页返回条数影响。本次实际请求返回 `8`。
`Resp.data`	array	当前页的重绘效果列表。无可见效果或分页越界时返回 `[]`。
`Resp.data[].restyle_id`	integer	重绘效果 ID。创建视频重绘任务时传入请求字段 `restyle_id`。
`Resp.data[].name`	string	重绘效果名称，仅用于展示和选择。
`Resp.data[].thumbnail`	string	重绘效果预览图 URL。

成功响应示例

以下示例根据国内环境 HTTP 200 的实际响应结构整理。为便于展示，data 仅保留一个效果项：

{
  "ErrCode": 0,
  "ErrMsg": "Success",
  "Resp": {
    "total": 8,
    "data": [
      {
        "restyle_id": 337045047320768,
        "name": "折纸艺术",
        "thumbnail": "https://media.pixverseai.cn/asset%2Ftemplate%2Forigami_250217.png"
      }
    ]
  }
}

Resp.total 表示接口返回的效果总数；上方示例仅为结构节选。客户端应遍历实际响应中的完整 Resp.data。

在视频重绘任务中使用

字段映射：

Resp.data[].restyle_id
            ↓
POST /openapi/v2/video/restyle/generate
            ↓
请求 Body 中的 restyle_id

示意请求：

{
  "source_video_id": 123456789,
  "restyle_id": 123
}

123 仅用于展示字段位置，不是真实枚举。请替换为列表接口实际返回的效果 ID。

注意事项

即使 HTTP 状态码为 200，也应继续检查业务错误码。

重绘效果可能随平台配置变化，不建议在客户端长期写死。

不要把效果名称或预览 URL 当作 restyle_id。

已保存的效果 ID 创建任务失败时，应重新获取列表并让用户重新选择。

下一步

取得真实效果 ID 后，调用：

列表行为

支持 page_num、page_size 分页，默认分别为 1、500。

不支持客户端筛选或自定义排序；服务端仅返回当前可见效果，并按平台固定顺序排列。

无可见效果或分页越界时，data 可能为空数组；此时仍应读取实际 total。

效果下架后会从列表隐藏。客户端不应长期写死效果 ID，应在创建任务前刷新列表。

获取视频重绘列表

获取视频重绘列表

接入流程

请求 Header

Query 参数

cURL 调试示例

响应字段

成功响应示例

在视频重绘任务中使用

注意事项

下一步

列表行为

请求参数

返回响应

获取视频重绘列表

获取视频重绘列表#

接入流程#

请求 Header#

Query 参数#

cURL 调试示例#

响应字段#

成功响应示例#

在视频重绘任务中使用#

注意事项#

下一步#

列表行为#

请求参数

返回响应

获取视频重绘列表

接入流程

请求 Header

Query 参数

cURL 调试示例

响应字段

成功响应示例

在视频重绘任务中使用

注意事项

下一步

列表行为