跳到主要内容

合成作品

1.接口说明​

配置完项目属性后，调用该接口提交作品合成请求，校验项目属性，开始制作视/音频。

2.请求地址​

https://digitbot.bokecc.com/api/project/compose

3.请求方式​

POST application/json

4.请求参数​

(1).公共参数，参考服务说明。​

(2).接口参数​

①.Query参数：通过URL参数传递。​

参数名类型必需说明
versionString是接口版本号，当前支持版本：1.0.0。
projectIdString是项目ID，创建项目时返回的唯一身份标识。

②.Body参数：通过请求Body传递，JSON格式。​

参数名类型必需说明
typeInteger否合成作品类型，枚举值。0=视频；1=音频。默认值：0。
nameString否合成作品名称，最长支持20个字符。默认使用项目名称。
callbackUrlString否合成结果回调地址。不传或callbackUrl无效时，不发送回调。
sameBoundsBoolean否是否使合成的视频首尾帧画面相同。参数值为true时开启策略。type=0时有效。默认值：false。2025-07-29：新增
  • 合成作品时，会根据要合成的作品类型，校验相关项目的配置数据，不符合合成要求时，无法合成作品。
  • 视频输出格式：mp4。
  • 音频输出格式：wav、mp3。
    • 使用AI声音"中文精品"分类下的声音时，输出音频为mp3。
    • 使用AI声音"英语"分类下的"臻**"系列声音时，输出音频为mp3。
    • 使用"中文"分类下的"风格2"~"风格8"时，输出音频为mp3。

5.请求示例​

POST https://digitbot.bokecc.com/api/project/compose?projectId=xxx&accountId=xxx&version=1.0.0&hash=xxx&time=xxx HTTP/1.1

{
    "type": 0,
    "name": "合成示例视频"
}

6.响应示例​

{
    "id": "xxx"
}

7.响应说明​

字段名类型说明
idString作品(任务)ID。