AI成片
更新时间：2024-07-09
AI成片-图文转视频
各接口用途说明
AI 成片，输入图文素材，一键生成短视频，自动实现配音、加字幕、素材匹配、添加数字人形象等环节。适用于企业宣传、营销推广、知识科普等场景，帮助创作者实现精美视频的快速产出。AI 成片涉及2个接口，分别为：AI 成片-图文转视频、AI 成片-查询结果。
- AI 成片-图文转视频：支持传入文本、图片、背景音乐等参数，创建 AI 成片任务，获得任务ID。
- AI 成片-查询结果：用于在任务创建后，查看视频生成状态。待视频生成完毕，通过查询接口即可查看生成视频的地址链接。
- 并发概念：并发数指 AI 成片服务同时能处理的请求数量。上一个任务执行完，拿到结果后，并发才结束。
- 并发数：付费使用后，AI成片视频生成处理过程并发提升为2。
AI成片-图文转视频
在线调试
您可以在示例代码中心 中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
接口描述
用于创建图文生成视频任务，提供文本素材、图片素材、必要参数，即可创建一个视频任务，得到任务id后可用于后续的查询操作。
请求说明
请求示例
- HTTP方法: POST
- 请求URL: https://aip.baidubce.com/rpc/2.0/brain/creative/ttv/material
- URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
- Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
- body请求参数:
| 参数 | 是否必选 | 类型 | 描述 |
|---|---|---|---|
| source | 是 | Object | 用于生成视频的图文内容与设置项 |
| +structs | 是 | Array | 文本、图片素材内容，必须包含文字段落和图片，structs中文本总长度在20-2000字符之间 |
| ++type | 是 | String | 内容类型，支持image（图片）、text（文字） |
| ++mediaSource | 是 | Object | 若内容类型type=image，该字段描述图片内容，支持jpg/jpeg/png格式的图片，当使用版权视频素材生成视频时，该字段为可选字段 |
| +++type | 是 | Number | 图片类型，支持url，固定传3 |
| +++url | 是 | String | 传入图片的url地址 |
| ++text | 否 | String | 若内容类型type=text，该字段描述文本内容 |
| config | 是 | Object | 视频生产配置 |
| +productType | 是 | String | 视频产出结果形式，支持产出为mp4和json格式。可选项为video、timeline。video: 产出结果为mp4视频；timeline: 产出结果为json时间轴信息； |
| +mediaLibs | 否 | Array | 素材库，默认使用原文素材，字段为["original"] |
| +duration | 否 | Number | 目标视频时长，单位为秒，默认-1（自动根据内容匹配时长）；支持选择：30、60、120、-1（自动根据内容匹配时长） |
| +ttsPer | 否 | int | 支持基础音库、甄选音库，默认4100:度小雯-女；【基础音库】0:度小美-女、1:度小宇-男、3:度小云-男、4:度小丫-女童、5:度小娇-女、103:度小朵-女童、106:度小博-男、110:度小童-男童、111:度小萌-女、5003:度小遥-男、5118:度小婷-女、4003:度小耀-男、4100:度小雯-女、4103:度小米-男童、4105:度小灵-女、4106:度小文-男、4115:度小贤-男、4117:度小乔-女、4119:度小鹿-女；【甄选音库】4144:度姗姗-女、4140:度小新-女、4143:度清风-男、4129:度小彦-男、4278:度小贝-女、4254:度小清-女、4149:度星河-男 |
| +resolution | 是 | Array | 分辨率，横屏支持[1920,1080]、[1280,720]、[1024,576]、竖屏支持[1080,1920]、[720,1280]、[576,1024] |
| +digitalHumanId | 否 | String | 数字人选择，支持 2：灿儿 、3：逍遥、4：关关、5：家乐，更多数字人敬请期待 |
| +bgMusic | 否 | Object | 背景音乐，支持使用mp3格式，文件大小不超过10M |
| ++mediaSource | 是 | Object | 需要指定背景音乐时，通过该字段进行添加 |
| +++type | 是 | Number | 背景音乐类型，支持url，固定传3 |
| +++url | 是 | String | 传入音频的url地址 |
| +videoBegin | 否 | Object | 视频片头，大小限制50M，格式为mp4或mov |
| ++mediaSource | 是 | Object | 需要指定视频片头来源时，通过该字段进行添加 |
| +++type | 是 | Number | 视频片头类型，支持url，固定传3 |
| +++url | 否 | String | 传入的视频片头url地址 |
| +videoEnd | 否 | Object | 视频片尾，大小限制50M，格式为mp4或mov |
| ++mediaSource | 是 | Object | 需要指定视频片尾来源时，通过该字段进行添加 |
| +++type | 是 | Number | 视频片尾类型，支持url，固定传3 |
| +++url | 否 | String | 传入的视频片尾url地址 |
| +caption | 否 | Object | 字幕显示设置 |
| ++marginBottom | 否 | Number | 字幕距离视频底部的位置，单位px，支持选择0-500。横屏默认值为70px；竖屏[1080,1920]默认为270px、[720,1280]默认为180px、[576,1024]默认为170px |
| ++fontColor | 否 | String | 字体颜色，支持传入颜色的十六进制，默认：ffffff |
| ++fontAlpha | 否 | Number | 字体透明度，范围：0-100，从透明到不透明，默认：100 |
| ++bgColor | 否 | String | 字幕背景颜色，支持传入颜色的十六进制，默认：927070 |
| ++bgAlpha | 否 | Number | 字幕背景透明度，范围：0-100，从透明到不透明，默认32 |
| +videoLogo | 否 | Object | 视频角标，支持jpg/jpeg/png类型的图片，大小限制1M |
| ++mediaSource | 是 | Object | 需要指定角标来源时，通过该字段进行添加 |
| +++type | 是 | Number | 角标类型，支持url，固定传3 |
| +++url | 否 | String | 传入角标图片的url地址 |
| ++location | 否 | String | 角标位置，支持：top-left（左上）、top-right（右上），默认为 top-left |
| ++margin | 否 | Number | 角标边缘距离，单位px，支持0-100，默认为 20 |
数字人形象预览
Body示例
{
"source": {
"structs": [{
"type": "text",
"text": "对于可控的事情，要保持谨慎； 对于不可控的事情，要保持乐观。人只能做自己能力范围内的事情，你要接受这个事实，并且以乐观的心，去应对这一切"
}, {
"type": "image",
"mediaSource": {
"type": 3,
"url": "http://xxx/a.jpeg"
}
}, {
"type": "text",
"text": "我们登上并非我们所选择的舞台，演出并非我们所选择的剧本，这时候我们经常会羡慕别人的剧本，我有时候非常羡慕别人的剧本，但是，没有谁的剧本值得羡慕，你只能把你自己的剧本给演好。"
}, {
"type": "image",
"mediaSource": {
"type": 3,
"url": "http://xxx/b.jpg"
}
}]
},
"config": {
"productType": "video",
"duration": -1,
"resolution": [1280, 720]
}
}返回说明
返回参数
| 参数 | 类型 | 详细说明 |
|---|---|---|
| log_id | Number | 日志id |
| error_msg | String | 错误信息 |
| error_code | Number | 错误码 |
| data | Object | 返回的数据 |
| +jobId | Number | 生成视频任务number类型任务id，用于查询任务状态，默认7天失效 |
| +id | String | 生成视频任务string类型任务id，用于查询任务状态，默认7天失效 |
返回示例
成功返回示例：
成功返回示例
{
"data": {
"jobId": 1717153286267015037,
"id": "1717153286267015037"
},
"log_id": 1717153286267015037
}
失败返回示例
{
"log_id": 1717156446855606171,
"error_msg": "分辨率选择错误，分辨率支持[1920,1080]、[1280,720]、[1024,576]、[1080,1920]、[720,1280]、[576,1024]",
"error_code": 30901
}错误码
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 30901 | 参数校验错误 | 参数校验错误，请根据提示信息纠正您的参数 |
AI成片-查询结果
接口描述
用于查询视频任务列表信息，或某个任务 id 的当前信息。
请求说明
请求示例
- HTTP方法: POST
- 请求URL: https://aip.baidubce.com/rpc/2.0/brain/creative/ttv/query
- URL参数：
| 参数 | 值 |
|---|---|
| access_token | 通过API Key和Secret Key获取的access_token，参考“Access Token获取” |
- Header如下：
| 参数 | 值 |
|---|---|
| Content-Type | application/json |
- body请求参数:
| 参数 | 是否必选 | 参数类型 | 参数说明 |
|---|---|---|---|
| jobId | 是 | Number或string | 任务id |
| includeTimeline | 否 | Boolean | 当「AI成片-图文转视频」接口中productType传入video类型时，可选择返回结果中是否包含timeline，支持true（返回）、false（不返回），默认为false； |
Body示例
请求示例1
{
"jobId": 1717153286267015037,
"includeTimeline": false
}请求示例2
{
"jobId": "1717153286267015037",
"includeTimeline": false
}返回说明
返回参数
| 参数 | 是否必须 | 类型 | 详细说明 |
|---|---|---|---|
| error_code | 是 | Number | 系统状态码，0表示成功，非0表示失败 |
| error_msg | 是 | String | 系统信息 |
| data | 是 | Object | 任务数据 |
| +statusCode | 是 | String | 任务状态，0: 任务排队中，1：任务完成，3：任务执行中，其他状态为异常，异常状态参见错误码 |
| +failReason | 是 | String | 任务失败信息 |
| +progress | 是 | Float | 任务进度，支持0-1，1为任务完成 |
| +timeline | 是 | Object | 时间轴信息 |
| +timelineVersion | 是 | String | 时间轴版本 |
| +videoAddr | 是 | String | 任务产出视频地址，默认有效期为7天 |
| +mediaLibs | 是 | Array | 任务所使用的素材库，original为原文素材 |
| ++points | 否 | Float | 本次生成消耗的点数，生成成功后返回该信息，保留两位小数 |
| ++basicDuration | 否 | Number | 本次生成视频基础时长，生成成功后返回该信息，单位毫秒，整数 |
| ++digitalHumanDuration | 否 | Number | 本次生成视频数字人时长，生成成功后返回该信息，单位毫秒，整数 |
错误码
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 15 | 并发超限 | 错误信息为中文的“并发超限”指单个用户使用 AI 成片的并发超限，请在控制台下单购买对应API资源包获取额度，如果仍无法解决，请提交工单或联系您的客户经理 |
| 30701 | 图片可能存在低质、格式错误等问题 | 图片可能存在低质、格式错误等问题，请更换图片后重新提交 |
| 30702 | 内容不适合生成视频（包含大量标点、字符、文本过短等） | 内容不适合生成视频（包含大量标点、字符、文本过短等），请修改文本后重新提交 |
| 30703 | 文本内容包含敏感信息 | 文本内容包含涉政敏感信息，请修改文本后重新提交 |
| 282000 | internal error | 任务处理失败，请重新提交任务，若持续出现此类错误，请通过工单联系技术支持 |
| 30901 | 参数校验错误 | 参数校验错误，请根据提示信息纠正您的参数 |
| 31001 | jobId信息已过期 | 内容已过期，仅支持查询七天内信息 |
点数抵扣说明
| 图文转视频基础时长（点/每分钟） | 数字人时长（点/每分钟） |
|---|---|
| 12 | 62 |
具体换算为视频分钟 x 每分钟抵扣点数，保留2位小数。260-320字的文本预计可生成1分钟视频。