爆款复刻 Agent

爆款复刻 Agent 根据一个参考视频、1–5 张商品或主体参考图片以及文本要求，复刻参考视频的分镜与节奏，并替换画面主体、生成口播、背景音乐和字幕。适用于商品营销视频、广告素材复刻和短视频批量生产。

接入流程

上传 1–5 张参考图片，获取每张图片的 img_id。

准备一个 2–30 秒的参考视频：上传后获取 video_media_id，或使用其他视频生成接口返回的 source_video_id。

编写复刻要求，包括商品卖点、主体替换、字幕和画面要求。

调用爆款复刻接口，获取 video_id 和 credits。

使用任务查询接口或 Webhook 获取最终状态；成功后读取视频地址。

接口地址

POST /openapi/v2/video/agent/generate

国内 Base URL：https://app-api.pixverseai.cn

完整地址：

https://app-api.pixverseai.cn/openapi/v2/video/agent/generate

前提条件

Agent

爆款复刻 Agent 的固定 agent_id 为 414562414124109。

其他 Agent ID 无效。

参考图片

img_references 必须提供 1–5 项。

每项填写图片上传接口返回的真实 img_id。

单张图片不超过 20 MB，宽和高均不得超过 10000 px。

建议上传主体清晰、角度互补且与复刻目标一致的图片。

参考视频

video_references 必须提供，当前仅支持 1 个参考视频。

视频时长为 2–30 秒，文件不超过 100 MB。

视频宽、高均应在 640–1920 px 范围内。

上传的视频填写 video_media_id；PixVerse 生成的视频填写 source_video_id。根据来源选择一个字段，不要同时填写。

建议使用无字幕、无水印且主体与镜头清晰的参考视频，以减少对复刻效果的干扰。

请求参数

Body 参数

字段	类型	是否必填	枚举值 / 限制	说明
`agent_id`	integer (int64)	是	`414562414124109`	爆款复刻 Agent 的固定 ID。
`prompt`	string	是	不超过 5000 字符	描述主体替换、商品卖点、口播、镜头、字幕及其他复刻要求。
`img_references`	object[]	是	1–5 项	参考图片列表，每项包含一个 `img_id`。
`video_references`	object[]	是	仅 1 项	参考视频列表，每项按来源填写 `video_media_id` 或 `source_video_id`。
`aspect_ratio`	string	否	`9:16`、`16:9`、`1:1`、`4:3`、`3:4`、`21:9`	输出比例；省略时默认跟随参考视频比例。
`quality`	string	否	`720p`、`1080p`	输出清晰度；省略时默认 `720p`。
`lip_sync_switch`	boolean	否	`true`、`false`	口播开关；省略时默认为 `true`。
`bgm_switch`	boolean	否	`true`、`false`	背景音乐开关；省略时默认为 `true`。
`caption_switch`	boolean	否	`true`、`false`	字幕开关；省略时默认为 `true`。
`webhook_id`	string	否	`405707753241879`	开放平台中已创建的 Webhook ID，不是回调 URL。

`img_references` 子字段

字段	类型	是否必填	示例	说明
`img_id`	integer (int64)	是	`192744142`	图片上传接口返回的图片 ID。

`video_references` 子字段

字段	类型	是否必填	示例	说明
`video_media_id`	integer (int64)	条件必填	`416271676884285`	视频上传接口返回的媒体 ID；使用上传视频时填写。
`source_video_id`	integer (int64)	条件必填	`123456789`	其他视频生成接口返回的视频 ID；使用 PixVerse 生成视频时填写。

video_media_id 与 source_video_id 根据参考视频来源二选一。

最小请求示例：使用上传视频

省略输出比例、清晰度和三个功能开关时，输出比例跟随参考视频，清晰度默认为 720p，口播、背景音乐和字幕默认开启。

{
  "agent_id": 414562414124109,
  "prompt": "将参考视频中的商品替换为参考图片中的商品，保留原有分镜和节奏，口播突出商品卖点。",
  "img_references": [
    {
      "img_id": 192744142
    }
  ],
  "video_references": [
    {
      "video_media_id": 416271676884285
    }
  ]
}

最小请求示例：使用生成视频

{
  "agent_id": 414562414124109,
  "prompt": "参考原视频的镜头节奏和构图，使用参考图片中的商品重新生成营销视频。",
  "img_references": [
    {
      "img_id": 192744142
    }
  ],
  "video_references": [
    {
      "source_video_id": 123456789
    }
  ]
}

响应字段

字段	类型	是否必有	说明
`ErrCode`	integer	是	业务错误码；成功时为 `0`。
`ErrMsg`	string	是	业务处理结果或错误信息。
`Resp`	object	成功时是	成功响应数据。
`Resp.video_id`	integer (int64)	成功时是	创建成功的视频任务 ID。
`Resp.credits`	integer	成功时是	创建接口返回的请求级点数。

响应示例

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

video_id 和 credits 仅为字段结构示例，实际值以接口实时响应为准。

成功判定与下一步

HTTP 200 只表示请求已到达服务端，不代表任务创建或视频生成成功。

检查 ErrCode 是否为 0。

保存返回的 Resp.video_id。

调用 GET /openapi/v2/video/result/{video_id} 或接收 Webhook。

任务进入成功状态后，确认返回的视频地址可以访问，才视为端到端完成。

常见错误与排查

场景	排查建议
API Key 无效	确认使用国内开放平台签发的 Key，并与 `app-api.pixverseai.cn` 配套使用。
参数值无效	检查 `agent_id`、图片数量、视频数量、视频时长、清晰度和画面比例。
图片引用无效	确认 `img_id` 来自图片上传接口，且图片未失效。
视频引用无效	按视频来源选择 `video_media_id` 或 `source_video_id`，不要同时填写。
素材不符合限制	检查图片和视频的格式、大小、分辨率与视频时长。
内容审核未通过	调整图片、视频和提示词，避免违规、侵权或误导性内容。
达到并发限制	等待进行中的任务结束后重试，并降低并行请求数。

注意事项

参考视频中的字幕和水印可能被模型复刻；建议使用干净素材，并通过 caption_switch 明确控制字幕。

提示词中的要求应与开关保持一致。例如要求“全程无字幕”时，应将 caption_switch 设为 false。

API Key 只放在 Header 中，并妥善保管。

使用商品、人物、品牌、音乐和参考视频前，应确保拥有必要授权，并遵守平台规则及适用法律。

爆款复刻 Agent