重绘功能使用指南

Restyle 功能可将你的视频片段即时转换为全新的视觉风格 —— 例如 3D、动漫、电影感或增强写实风格。无论你想打造艺术风格还是品牌视觉，Restyle 都能赋予你创造专属世界的强大能力。

接口地址：POST https://app-api.pixverseai.cn/openapi/v2/video/restyle/generate

获取重绘列表地址: GET https://app-api.pixverseai.cn/openapi/v2/video/restyle/list

在线调用：

上传资源（视频/音频）：https://docs.platform.pai.video/311775440e0

前提条件

开始之前，请确保您拥有：

有效的拍我AI API 密钥

每个API请求的唯一 Ai-trace-id

已开通并激活订阅计划，且账户中有足够可用额度；

以下任一：

从拍我AI 生成的 video_id
或者

支持格式的上传视频（mp4、mov）

最大分辨率：1920

最大文件大小：50MB

最大时长：16秒

restyle_id 来自列表接口 or restyle_prompt 想变换的风格

快速调用

1: 准备视频

2. Restyle重绘生成任务请求

3. 查询视频状态&下载视频

使用步骤

您可以通过两种方式输入视频：

步骤 1-1：准备外部视频

外部视频（用户提供）

为确保最佳效果，请提供：

.mp4 或 .mov 视频文件

最大分辨率：1920p

最大大小：50MB

最大时长：16秒

使用适当的参数构建您的API请求：

您将获得带有"video"媒体类型的"media_id"

{
    "ErrCode": 0,
    "ErrMsg": "success",
    "Resp": {
        "media_id": 0,
        "media_type": "video",
        "url": "https://media.pixverseai.cn/111111.mp4"
    }
}

步骤 1-2：从拍我AI API 准备视频

如果您之前使用我们的API生成了视频，您应该已经有一个 video_id。
要扩展此视频，请将 video_id 传递到生成请求的 source_video_id 字段中。最大16s视频

步骤 2：发送延长(Restyle)API请求

🔧 参数详情

参数名称	必需	类型	描述
source_video_id	选择 source_video_id 或 video_media_id 之一，不能同时使用	int	来自拍我AI API 的视频
video_media_id	选择 source_video_id 或 video_media_id 之一，不能同时使用	int	上传的外部视频
restyle_id	选择 restyle_id 或 restyle_prompt 之一，不能同时使用	int	restyle_id 来自列表
restyle_prompt	选择 restyle_id 或 restyle_prompt 之一，不能同时使用	string	小于等于 2048 字符, 不能传空
seed	可选	integer	随机种子，0-2147483647 之间的 int32 随机数

步骤 3. 处理API响应

API返回包含 video_id 的JSON响应：

{
  "ErrCode": 0,
  "ErrMsg": "success",
  "Resp": {
    "video_id": 0
  }
}

步骤 4 检查生成状态

创建任务后，您将收到一个 video_id

使用此 video_id 定期查询获取视频生成状态API

处理完成时，状态将从 5 变为 1

  {
 "ErrCode": 0,
 "ErrMsg": "string",
 "Resp": {
   "create_time": "string",
   "id": 0,
   "modify_time": "string",
   "negative_prompt": "string",
   "outputHeight": 0,
   "outputWidth": 0,
   "prompt": "string",
   "resolution_ratio": 0,
   "seed": 0,
   "size": 0,
   "status": 5,
   "style": "string",
   "url": "string"
 }
}

步骤 5 下载生成的视频

您可以通过"url"访问生成的视频

  {
 "ErrCode": 0,
 "ErrMsg": "string",
 "Resp": {
   "create_time": "string",
   "id": 0,
   "modify_time": "string",
   "negative_prompt": "string",
   "outputHeight": 0,
   "outputWidth": 0,
   "prompt": "string",
   "resolution_ratio": 0,
   "seed": 0,
   "size": 0,
   "status": 1,
   "style": "string",
   "url": "string"
 }
}

故障排除

常见问题

您的视频卡在"生成中"状态，长时间等待后仍未完成。

请检查您是否为每个请求使用相同的 AI-trace-ID。这是导致此问题的最常见原因。

状态代码：1：生成成功；5：等待生成；7：内容审核失败；8：生成失败；

如果遇到状态代码 7，意味着您生成的视频被我们的内容审核系统过滤。请修改参数后重试。用于被过滤视频的积分将自动退还到您的账户。

常见错误代码

400/500 状态：代码错误

400013：无效的绑定请求：参数类型或值不正确

400017：无效参数

500044：达到并发生成限制

前提条件#

快速调用#

使用步骤#

步骤 1-1：准备外部视频#

步骤 1-2：从 拍我AI API 准备视频#

步骤 2：发送延长(Restyle)API请求#

步骤 3. 处理API响应#

步骤 4 检查生成状态#

步骤 5 下载生成的视频#

故障排除#

常见问题#

常见错误代码#