多主体(产考图生成视频) 功能允许你基于多张参考图像快速生成视频。
这些图像可以包括主体和背景，并可通过 prompt 引导，将它们自然组合成连贯的场景。多主体(产考图生成视频) 特别适用于电商展示、品牌广告、剧情类短片等场景。

使用前提

开始使用前，请确保你具备以下条件：

有效的拍我AI API Key

每个请求使用唯一的 Ai-Trace-Id

有效的套餐计划

已上传用于多主体的参考图像，并获得对应的 img_id

使用步骤

步骤 1 准备你的图像

使用高质量、清晰的图像，推荐使用高清分辨率以获得更好效果。

对于“主体”图像，请选择主体明显、清晰分离的图片。

对于“背景”图像，选择背景干净、边界清晰的图像。

步骤 2 调用上传图像接口，获取 img_id

构建如下 API 请求上传图像，获取用于 Fusion 的 img_id：

步骤 3 调用多主体(产考图生成视频) 接口

参数说明

参数名	是否必填	类型	说明
image_references	是	array	图像引用数组（1–3 项），包含“主体”或“背景”
prompt	是	string	使用 `@ref_name` 精确描述场景 1. `@ref_name` 后必须有空格，如 `@cat plays` 2. prompt 中引用的名称必须与 image_references 中的 `ref_name` 完全一致
model	是	string	模型版本，仅支持 v4.5 及以上
duration	是	int	视频时长（支持 5 或 8 秒）
quality	是	string	视频分辨率，如 "540p"
aspect_ratio	是	string	视频宽高比，如 "16:9"
seed	否	int	随机种子，用于结果复现

注意事项：

image_references 必须为非空数组（长度 1–3），每项包含字段 "img_id"、"ref_name"、"type"。

"type" 必须为支持的类型（如：subject 或 background），详见 API 文档。

ref_name 必须在数组中唯一。

Fusion 功能仅支持 model v4.5 及以上。

使用 prompt 时：

引用 ref_name 时需以 @ 开头

后面需跟一个空格，如 @dog plays

引用名称必须与 image_references 中一致

步骤 4 处理 API 返回结果

接口将返回包含 video_id 的 JSON 响应：

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

步骤 5 检查生成状态

创建任务后，您将收到一个 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"
 }
}

步骤 6 下载生成的视频

您可以通过"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 准备你的图像#

步骤 2 调用上传图像接口，获取 img_id#

步骤 3 调用 多主体(产考图生成视频) 接口#

参数说明#

注意事项：#

步骤 4 处理 API 返回结果#

步骤 5 检查生成状态#

步骤 6 下载生成的视频#

故障排除#

常见问题#

常见错误代码#