数字人口播混剪视频

视频生成方式（二选一）

方式一：基于“文本内容 + 定制声音”生成视频

文本内容：字符数要求（3 ~ 1,800字符）
声音ID：声音定制产生的声音ID

方式二：基于“音频文件”生成视频

音频文件要求：

时长：0.5秒 ~ 5分钟
格式：mp3、wav（推荐）、m4a（仅支持Apple Lossless (ALAC) 编码格式的）
文件大小：小于等于100MB
需要能够语音转文本

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

包装规则说明

包装规则字段packRules仅用于控制“标题”、“字幕”、“素材”、“背景音乐”、“关键词”等图层是否参与效果包装，不能控制对应图层的显示\隐藏，在不做任何设置的情况下，包装规则由模板本身控制。
如果您期望生成的视频不显示标题，请不要设置标题值。

音频驱动的audioUrl、素材（materials）的链接、背景音乐的audioUrl、AI封面的resultImageUrl、背景图层（backgroundLayer）资源图片的地址规则：

不能重名，重名会导致渲染异常；
建议不要使用中文文件名。

素材要求

总量限制：单张图片计算为 2秒，单个视频素材不能超过60秒，所有素材总时长不能超过5分钟;
图片
- 格式：支持jpg、png、webp静态图
- 分辨率：
  当renderResolution输入1080时，最大支持2k（单边不大于2000，2000X2000）
  当renderResolution输入2160时，最大支持4k（单边不大于4000，4000X4000）
视频
- 格式：mp4、mov
- 视频编码：h264、HEVC(h265)
- 帧率：10～60fps，推荐 25
- 时长：小于60秒
- 视频大小：单个视频小于500MB
- 分辨率：
  当renderResolution输入1080时，最大支持2k（单边不大于2000，2000X2000）
  当renderResolution输入2160时，最大支持4k（单边不大于4000，4000X4000）
背景音乐要求：
- 格式：mp3、wav（推荐）、m4a（仅支持Apple Lossless (ALAC) 编码格式的）
- 文件大小：<=120MB
- 时长：<=5分钟

firstFrameCover封面（imageUrl、resultImageUrl）要求：

格式：jpg/jpeg、png
文件大小：小于等于10MB
分辨率：单边小于2000px

背景图层（backgroundLayer）资源图片要求：

格式：jpg/jpeg、png
文件大小：小于等于10MB
分辨率：单边小于2000px

请求参数

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,
        "materialMatchWay": "fuzzyMatch",
        "metadata": {
            "AIGC": "{\"Label\":\"1\",\"ContentProducer\":\"AI服务提供者的名称或统一社会信用代码等\",\"ProduceID\":\"XXXXXXXXXXXXXXXXXXX\"}"
        }
    },
    "subtitle": [
        {
            "startMs": 0,
            "endMs": 500,
            "text": "A"
        },
        {
            "startMs": 500,
            "endMs": 1000,
            "text": "I"
        },
        {
            "startMs": 1000,
            "endMs": 1500,
            "text": "行"
        },
        {
            "startMs": 1500,
            "endMs": 2000,
            "text": "业"
        },
        {
            "startMs": 2000,
            "endMs": 2500,
            "text": "是"
        },
        {
            "startMs": 2500,
            "endMs": 3000,
            "text": "一"
        },
        {
            "startMs": 3000,
            "endMs": 3500,
            "text": "个"
        },
        {
            "startMs": 3500,
            "endMs": 4000,
            "text": "充"
        },
        {
            "startMs": 4000,
            "endMs": 45000,
            "text": "满"
        },
        {
            "startMs": 4500,
            "endMs": 5000,
            "text": "机"
        },
        {
            "startMs": 5000,
            "endMs": 5500,
            "text": "遇"
        },
        {
            "startMs": 5500,
            "endMs": 6000,
            "text": "的"
        },
        {
            "startMs": 6000,
            "endMs": 6500,
            "text": "行"
        },
        {
            "startMs": 6500,
            "endMs": 7000,
            "text": "业"
        }
    ],
    "structLayers": [
        {
            "markCode": "headerLayer",
            "show": true,
            "showMode": "customize",
            "showTime": 2,
            "layer": {
                "transform": {
                    "position": [
                        0,
                        0,
                        0
                    ]
                }
            }
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.shanjian.tv/v1/clip/video/virtualman_broadcast' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "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,
        "materialMatchWay": "fuzzyMatch",
        "metadata": {
            "AIGC": "{\"Label\":\"1\",\"ContentProducer\":\"AI服务提供者的名称或统一社会信用代码等\",\"ProduceID\":\"XXXXXXXXXXXXXXXXXXX\"}"
        }
    },
    "subtitle": [
        {
            "startMs": 0,
            "endMs": 500,
            "text": "A"
        },
        {
            "startMs": 500,
            "endMs": 1000,
            "text": "I"
        },
        {
            "startMs": 1000,
            "endMs": 1500,
            "text": "行"
        },
        {
            "startMs": 1500,
            "endMs": 2000,
            "text": "业"
        },
        {
            "startMs": 2000,
            "endMs": 2500,
            "text": "是"
        },
        {
            "startMs": 2500,
            "endMs": 3000,
            "text": "一"
        },
        {
            "startMs": 3000,
            "endMs": 3500,
            "text": "个"
        },
        {
            "startMs": 3500,
            "endMs": 4000,
            "text": "充"
        },
        {
            "startMs": 4000,
            "endMs": 45000,
            "text": "满"
        },
        {
            "startMs": 4500,
            "endMs": 5000,
            "text": "机"
        },
        {
            "startMs": 5000,
            "endMs": 5500,
            "text": "遇"
        },
        {
            "startMs": 5500,
            "endMs": 6000,
            "text": "的"
        },
        {
            "startMs": 6000,
            "endMs": 6500,
            "text": "行"
        },
        {
            "startMs": 6500,
            "endMs": 7000,
            "text": "业"
        }
    ],
    "structLayers": [
        {
            "markCode": "headerLayer",
            "show": true,
            "showMode": "customize",
            "showTime": 2,
            "layer": {
                "transform": {
                    "position": [
                        0,
                        0,
                        0
                    ]
                }
            }
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}'

视频生成方式（二选一）

包装规则说明

音频驱动的audioUrl、素材（materials）的链接、背景音乐的audioUrl、AI封面的resultImageUrl、背景图层（backgroundLayer）资源图片的地址规则：

素材要求

firstFrameCover封面（imageUrl、resultImageUrl）要求：

背景图层（backgroundLayer）资源图片要求：

请求参数

请求示例代码

返回响应