Create Video Creation Task
Updated: 2026-07-13 11:57:31
API Description
1、创建视频创作任务, 接口支持批量创建任务, 单次最多支持20个
2、接口支持https协议
API URL
http://api.polyv.net/live/v4/ai/video-produce/create-batch
Online API Call
Request Method
POST
API Constraints
- The API supports both HTTP and HTTPS. HTTPS is recommended for security. API calls have frequency limits. See details
URL Request Parameter Description (for signing)
Body (application/json) Parameter Description
ttsVoiceInfo Parameter Description
subtitleInfo Parameter Description
materialInfos Parameter Description
Notes:
- A single video creation task supports a maximum of 100 pages of material (100 background images and voiceover scripts).
- The voiceover script for a single task is limited to 25,000 characters.
digitalHumanInfos Parameter Description
Explanation of digitalHumanInfos:
- This parameter is a collection type. If the current task does not require a digital human, this parameter does not need to be passed.
- This parameter is used to control the display and hiding of the digital human on each page of material, as well as to adjust the digital human's size and position.
- If the material is a PPT, adjusting the digital human's display/hiding, size, and position on each PPT page is not supported. (Only one set of digital human ID, size, and position information is needed. The digital human's size and position will be the same across all PPT video pages.)
- If the material consists of custom background images and custom voiceover scripts, this parameter can be used to control whether the digital human is displayed on each voiceover page, as well as its size and position. However, note that you must pass as many sets of digital human size and position information as there are pages of material (one background image + one voiceover script equals one page). If only one set is passed, it is assumed that the digital human is displayed on every page of material, and its size and position remain consistent.
Other Notes:
- Currently, a single video creation task supports a maximum of one digital human.
Examples:
- Material uses a PPT and requires a digital human. Only one set of digital human size and position is needed.
[
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
}
]
- Custom material requires a digital human. Assume there are three pages of material. The first page needs the digital human displayed, the second page does not, and the third page needs it displayed with adjusted size and position compared to the first page.
[
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
},
{
"digitalHumanId": null,
"x": null,
"y": null,
"w": null,
"h": null
},
{
"digitalHumanId": 15,
"x": "1012",
"y": "147",
"w": "367",
"h": "530"
}
]
- Custom material requires a digital human. If the digital human is displayed on all pages with the same size and position, passing one set of size and position parameters is sufficient.
[
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
}
]
Recommended default size and position parameters for digital humans (different materials generally require different digital human size and position parameters. It is recommended to visualize the digital human's size and position first, then adjust it in the interface):
- 16:9 landscape video, digital human on the right: x: 1325, y: 28, w: 588, h: 1045
- 16:9 landscape video, digital human on the left: x: 3, y: 80, w: 562, h: 1000
- 9:16 portrait video: x: 10, y: 25, w: 1060, h: 1888
Example
http://api.polyv.net/live/v4/ai/video-produce/create-batch?timestamp=1716107535043&appId=gopl67qi7e&sign=6625340A6017272DF55CD1F5DC42CFCB
// ppt + 无数字人
[
{
"videoName": "ppt素材-无数字人",
"hasDigitalHuman": false,
"ttsVoiceInfo": {
"ttsVoiceId": 79,
"rate": "1.0"
},
"fileId": "abdd872ffae85752080989ca505b9525c560fac50fpptVideocommon",
"subtitleInfo": {
"enableSubtitle": true
}
}
]
// ppt + 有数字人
[
{
"videoName": "ppt素材-有数字人",
"hasDigitalHuman": true,
"ttsVoiceInfo": {
"ttsVoiceId": 79,
"rate": "1.2"
},
"fileId": "47023bd9a36fa692770e330a190fa7a9c560fac50fpptVideocommon",
"subtitleInfo": {
"enableSubtitle": false
},
"digitalHumanInfos": [
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
}
]
}
]
// 自定义素材 + 无数字人
[
{
"videoName": "自定义素材-无数字人",
"hasDigitalHuman": false,
"ttsVoiceInfo": {
"ttsVoiceId": 79,
"rate": "1.3"
},
"subtitleInfo": {
"enableSubtitle": false
},
"materialInfos": [
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "你好"
},
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/9_16/img/3simple/simple21.jpg",
"remark": "这里是保利威视频创作"
}
]
}
]
// 自定义素材 + 有数字人 + 全部页素材的数字人大小位置都一样
[
{
"videoName": "自定义素材-有数字人",
"hasDigitalHuman": true,
"ttsVoiceInfo": {
"ttsVoiceId": 79,
"rate": "1.3"
},
"subtitleInfo": {
"enableSubtitle": false
},
"materialInfos": [
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "你好"
},
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "这里是保利威视频创作"
}
],
"digitalHumanInfos": [
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
}
]
}
]
// 自定义素材 + 有数字人 + 自定义数字人显示和数字人大小位置
[
{
"videoName": "有数字人-素材-000000000",
"hasDigitalHuman": true,
"ttsVoiceInfo": {
"ttsVoiceId": 79,
"rate": "1.3"
},
"subtitleInfo": {
"enableSubtitle": false
},
"materialInfos": [
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "你好"
},
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "这里是保利威视频创作"
},
{
"backgroundImage": "https://img.videocc.net/e5f34f7744/html/adv/video-produce/background-image/16_9/img/5landscape/landscape7.jpg",
"remark": "感谢您的支持和使用"
}
],
"digitalHumanInfos": [
{
"digitalHumanId": 15,
"x": "1412",
"y": "247",
"w": "467",
"h": "830"
},
{
"digitalHumanId": null,
"x": null,
"y": null,
"w": null,
"h": null
},
{
"digitalHumanId": 15,
"x": "1012",
"y": "147",
"w": "367",
"h": "530"
}
]
}
]
Response Parameter Description
Response Example
Success Example
{
"code": 200,
"status": "success",
"requestId": "e90aba2c69a24bab894c7f708b853b75.71.17161341126309441",
"data": true,
"success": true
}
Error Parameter Description
