数字人口播混剪视频

POST

/v1/clip/video/virtualman_broadcast

包装规则说明

包装规则字段用于控制：“标题开关、字幕开关、关键词开关、素材开关、背景音乐开关”等，在不做任何设置的情况下，包装规则由模板本身控制。

如果您期望生成的视频关闭标题显示、关闭字幕显示等，请在packRules字段中设置对应的开关值。

视频生成方式：【文本content+音色speakerId】和【音频audioUrl】二选一，2种方式都传情况下，优先【音频audioUrl】

请求参数

Header 参数

Body 参数application/json

示例

{
    "styleId": "68aebb91b8619ed6f4168f40",
    "virtualmanId": "68aebb91b8619ed6f4168f40",
    "audioUrl": "https://golden-final.com/a.mp3",
    "speakerId": "68aebb91b8619ed6f4168f40",
    "speakerExtra": {
        "speedRatio": 1,
        "language": "zh-CN",
        "marks": [
            {
                "type": "break",
                "index": 3,
                "time": 2000
            }
        ]
    },
    "content": "AI行业是一个充满机遇的行业",
    "title": "聊AI行业",
    "materials": [
        {
            "type": "image",
            "fileUrl": "https://golden-final.com/a.jpg"
        },
        {
            "type": "video",
            "fileUrl": "https://golden-final.com/b.jpg"
        }
    ],
    "materialSoundSwitch": false,
    "introduceCard": {
        "name": "廖志勇",
        "description": "AI行业领军任务"
    },
    "packRules": {
        "headerSwitch": true,
        "materialSwitch": true,
        "subtitleSwitch": true,
        "keywordSwitch": true,
        "backgroundMusic": {
            "audioSwitch": true,
            "audioUrl": "https://golden-final.com/bg.mp3",
            "volume": 1
        }
    },
    "processRules": {
        "watermarkShow": true
    },
    "subtitles": [
        {
            "startMs": 0,
            "endMs": 1000,
            "text": "AI行业"
        },
        {
            "startMs": 1000,
            "endMs": 2000,
            "text": "是一个"
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.shanjian.tv/v1/clip/video/virtualman_broadcast' \
--header 'Authorization: Bearer {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "styleId": "68aebb91b8619ed6f4168f40",
    "virtualmanId": "68aebb91b8619ed6f4168f40",
    "audioUrl": "https://golden-final.com/a.mp3",
    "speakerId": "68aebb91b8619ed6f4168f40",
    "speakerExtra": {
        "speedRatio": 1,
        "language": "zh-CN",
        "marks": [
            {
                "type": "break",
                "index": 3,
                "time": 2000
            }
        ]
    },
    "content": "AI行业是一个充满机遇的行业",
    "title": "聊AI行业",
    "materials": [
        {
            "type": "image",
            "fileUrl": "https://golden-final.com/a.jpg"
        },
        {
            "type": "video",
            "fileUrl": "https://golden-final.com/b.jpg"
        }
    ],
    "materialSoundSwitch": false,
    "introduceCard": {
        "name": "廖志勇",
        "description": "AI行业领军任务"
    },
    "packRules": {
        "headerSwitch": true,
        "materialSwitch": true,
        "subtitleSwitch": true,
        "keywordSwitch": true,
        "backgroundMusic": {
            "audioSwitch": true,
            "audioUrl": "https://golden-final.com/bg.mp3",
            "volume": 1
        }
    },
    "processRules": {
        "watermarkShow": true
    },
    "subtitles": [
        {
            "startMs": 0,
            "endMs": 1000,
            "text": "AI行业"
        },
        {
            "startMs": 1000,
            "endMs": 2000,
            "text": "是一个"
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "string",
    "data": {
        "taskId": "string"
    },
    "message": "string"
}

修改于 2025-09-12 03:19:08

智能剪辑模板列表

真人口播混剪视频

数字人口播混剪视频

包装规则说明#

请求参数

请求示例代码

返回响应

包装规则说明