图生视频 / 视频模板

图生视频

图生视频适合让一张图片动起来，常用于人物动态、产品展示、海报转视频、角色动作生成等场景。调用前需要先上传图片并获取 img_id。

能力示例视频

适用场景

场景	说明
图片动态化	让人物、商品、风景或插画产生运动
角色一致性	用参考图保持主体外观，再通过 prompt 控制动作
模板/特效素材	为模板生成准备图片素材

接入流程

上传图片 -> 获取 img_id -> 发起图生视频任务 -> 查询任务状态或等待 Webhook 回调 -> 获取视频 URL

接口地址

前置步骤

先调用「上传图片」接口，获取 img_id：

请求参数

参数	类型	是否必填	说明
`model`	string	是	模型名称：`c1`、`v6`、`v5.6`、`v5`。新接入优先使用 `c1` 或 `v6`
`img_id`	integer	是	上传图片后获得的图片 ID
`prompt`	string	是	正向提示词，最长 `5000` characters（不分中英文)
`duration`	integer	是	视频时长：`c1` / `v6` 支持 `1~15` 秒；`v5.6` 支持 `5` / `8` / `10` 秒；`v5` 支持 `5` / `8` 秒。
`quality`	string	是	分辨率：`360p`、`540p`、`720p`、`1080p`
`seed`	integer	否	随机种子
`template_id`	integer	否	模板 ID，具体id请通过模版列表获取
`generate_audio_switch`	boolean	否	是否生成音效，默认开启控制开关 Audio. true: Audio on, false: Audio off ，`v5.5`,`v5.6`,`v6`,`c1` 模型支持开关
`generate_multi_clip_switch`	boolean	否	是否生成多镜头；默认关闭 `v6` 支持开关，控制单镜头、多镜头：true 表示多镜头，false 表示单镜头
`sound_effect_switch`	boolean	否	是否生成音效；`v5` 旧版音效字段或使用 `template_id` 时支持。新接入建议使用独立「音效生成 Sound Effect」接口。
`sound_effect_content`	string	否	音效描述；为空时可根据视频内容生成
`lip_sync_switch`	boolean	否	是否启用对口型；`v5` 旧版字段。新接入建议使用独立「对口型 Lipsync」接口。
`lip_sync_tts_content`	string	否	TTS 文本，约 `140` characters；`v5` 旧版字段。
`lip_sync_tts_speaker_id`	string	否	TTS 音色 ID，需通过音色接口获取；`v5` 旧版字段。

最小请求示例

{
  "duration": 5,
  "img_id": 123456,
  "model": "v6",
  "prompt": "Make the subject walk forward slowly",
  "quality": "720p",
  "generate_audio_switch": false,
  "seed": 0
}

常用参数组合

目标	推荐设置
快速验证链路	单图 `img_id` + `model=v6` + `quality=540p`
更强人物/动作效果	`model=c1`，prompt 明确动作、镜头和情绪
多图或模板玩法	根据模板要求传 `img_ids` 或 `template_id`

字段填写备注

字段类型	填写建议
`API-KEY`	使用正式 API Key，不要放在 URL Query 中。
`Ai-trace-id`	每次请求使用新的 UUID，用于链路追踪；该字段不保证幂等，重复提交仍可能创建新任务。
`img_id`	先调用上传图片接口获取；普通图生视频只使用单个 `img_id`。
`template_id`	仅在使用已激活的视频模板或特效时填写；普通图生视频可省略。

响应字段

字段	类型	说明
`Resp.video_id`	integer	视频任务 ID
`Resp.credits`	integer	创建响应返回的任务积分计算值；最终扣费以账户用量明细和任务最终状态为准

响应示例

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

下一步

调用「查询任务状态」接口，通过 video_id 获取生成结果。

注意事项

图片需先通过「上传图片」接口获取 img_id，不要直接传图片 URL。

视频时长需按模型能力传参：c1 / v6 支持 1~15 秒；v5.6 支持 5 / 8 / 10 秒；v5 支持 5 / 8 秒。

prompt 建议描述主体动作、镜头运动和画面氛围，避免只写风格词。

img_ids 通常用于多图模板或特定功能，普通图生视频使用 img_id 即可。

视频模板

视频模板用于基于已配置模板生成视频，适合营销、社媒、娱乐等固定玩法场景。

能力示例视频

适用场景

场景	说明
固定玩法复用	同一模板反复替换素材，适合活动或运营玩法
图片生成视频	根据模板要求传入单张或多张图片
特效场景	使用已激活模板快速生成特定效果

使用流程

确认模板 → 上传素材 → 调用模板生成接口 → 查询任务状态

接口地址

前置条件

从模板中心获取模板 ID；

根据模板要求上传图片或素材。

生成时传入模板 ID 和对应素材 ID。

多图模板根据模板要求传入 img_ids。

常见参数

参数	类型	是否必填	说明
`template_id`	integer	是	模板 ID，具体内容请通过模板列表获取
`duration`	integer	是	传 `5` 即可，实际时长按模板生成，模板固定时长时该字段
`model`	string	是	模型名称：`c1`、`v6`、`v5.6`、`v5`。模板效果主要由 `template_id` 决定，传任何模型即可, 模版与模型不相关。
`img_id`	integer	是	单图模板常用图片 ID
`img_ids`	array	视模板而定	多图模板使用
`sound_effect_switch`	boolean	否	如果想带背景音乐, 传`true`, 默认为`false`
`quality`	string	是	分辨率

必填参数以接口定义为准：duration、model、quality、img_id、template_id。

模板相关错误

Code	说明
`500070`	当前模板未激活
`500071`	当前特效不支持指定分辨率

使用建议

在正式接入前，先确认模板是否已激活。

确认模板支持的分辨率和素材数量。

多图模板请按模板要求传入 img_ids。

如果模板生成失败，优先检查模板是否激活、分辨率是否支持、素材数量是否正确。

最小请求示例

{
  "duration": 5,
  "model": "v6",
  "quality": "720p",
  "img_id": 123456,
  "template_id": 10001,
  "prompt": ""
}

响应字段

字段	类型	说明
`ErrCode`	integer	错误码，`0` 表示成功
`ErrMsg`	string	错误信息，成功时通常为 `Success`
`Resp.video_id`	integer	视频任务 ID，后续用于查询任务状态
`Resp.credits`	integer	创建响应返回的任务积分计算值，用于展示和初步对账；最终扣费以账户用量明细和任务最终状态为准

响应示例

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

图生视频#

能力示例视频#

适用场景#

接入流程#

接口地址#

前置步骤#

请求参数#

最小请求示例#

常用参数组合#

字段填写备注#

响应字段#

响应示例#

下一步#

注意事项#

视频模板#

能力示例视频#

适用场景#

使用流程#

接口地址#

前置条件#

常见参数#

模板相关错误#

使用建议#

最小请求示例#

响应字段#

响应示例#

请求参数

返回响应

图生视频

能力示例视频

适用场景

接入流程

接口地址

前置步骤

请求参数

最小请求示例

常用参数组合

字段填写备注

响应字段

响应示例

下一步

注意事项

视频模板

能力示例视频

适用场景

使用流程

接口地址

前置条件

常见参数

模板相关错误

使用建议

最小请求示例

响应字段

响应示例