闪剪AI开放平台
  1. 视频合成
闪剪AI开放平台
  • 产品介绍
    • 产品简介
    • 产品定价
    • 功能介绍
    • 常见问题
  • 开发指南
    • 快速接入
    • 错误码
    • 支持语种代码参照
  • 克隆
    • 专业数字人克隆
      POST
    • 极速数字人克隆
      POST
    • 声音克隆
      POST
    • 数字人/声音删除
      DELETE
  • 视频合成
    • 数字人口播视频(无包装)
      POST
    • 智能剪辑模板列表
      GET
    • 数字人口播混剪视频
      POST
    • 真人口播混剪视频
      POST
    • 音频转文字(ASR)
      POST
  • 任务查询
    • 查询任务详情
      GET
  • 相关协议
    • 用户协议
    • 隐私政策
    • 付费协议
    • 实名协议
  • 数据模型
    • 定制及制作类任务响应
    • 制作任务结果回调数据
  1. 视频合成

真人口播混剪视频

POST
/v1/clip/video/realman_broadcast

包装规则说明#

包装规则字段用于控制:“标题开关、字幕开关、关键词开关、素材开关、背景音乐开关”等,在不做任何设置的情况下,包装规则由模板本身控制。
如果您期望生成的视频关闭标题显示、关闭字幕显示等,请在packRules字段中设置对应的开关值。

特殊字段说明#

subtitles(字幕信息)
选填,不设置则由系统智能处理。
使用场景:如果您期望手动修改从视频中识别的文字,可以先调用“音频转文字(ASR)”接口识别出文本信息,并更改其中的文字(例如:错别字等),然后保持ASR返回的格式,设置到该字段上。
processRules.resourcePreprocessMethod(真人视频预处理方式)
选填,不设置真人视频预处理方式时,默认保持原始视频时长。
预处理方式如下:
roughCut:粗剪,按照系统内置规则智能处理,例如:自动去掉无声片段等。
sliceMerge:按照subtitles(字幕)字段中标注的开始\结束时间,自动去掉不连续时间范围的片段,例如:
// 假设有如下subtitles字段,由于“是”和“第”字幕之间,产生了3.8秒的间隔,这时会将视频的第 200ms - 4秒 给裁掉:
[{
  "startMs": 0, "endMs": 100, "text": "这"
},{
  "startMs": 100, "endMs": 200, "text": "是"
},{
  "startMs": 4000, "endMs": 4300, "text": "第"
},{
  "startMs": 4300, "endMs": 4700, "text": "1"
},{
  "startMs": 5000, "endMs": 5300, "text": "个"
},{
  "startMs": 5500, "endMs": 5700, "text": "镜"
},{
  "startMs": 5700, "endMs": 6000, "text": "头"
}]

请求参数

Header 参数

Body 参数application/json

示例
{
    "styleId": "68aebb91b8619ed6f4168f40",
    "videoUrl": "https://golden-final.com/a.mp4",
    "title": "聊AI行业",
    "language": "zh-CN",
    "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,
        "resourcePreprocessMethod": "roughCut"
    },
    "subtitles": [
        {
            "startMs": 0,
            "endMs": 1000,
            "text": "AI行业"
        },
        {
            "startMs": 1000,
            "endMs": 2000,
            "text": "是一个"
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.shanjian.tv/v1/clip/video/realman_broadcast' \
--header 'Authorization: Bearer {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "styleId": "68aebb91b8619ed6f4168f40",
    "videoUrl": "https://golden-final.com/a.mp4",
    "title": "聊AI行业",
    "language": "zh-CN",
    "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,
        "resourcePreprocessMethod": "roughCut"
    },
    "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-10 03:04:58
上一页
数字人口播混剪视频
下一页
音频转文字(ASR)
Built with