闪剪 AI 开放平台
  1. 视频合成
闪剪 AI 开放平台
  • 产品介绍
    • 产品简介
    • 产品定价
    • 功能介绍
    • 常见问题
    • 元数据-AI 显式标识和隐式标识说明
  • 开发指南
    • 快速接入
    • 错误码
    • 支持语种代码参照
    • 风格模板编辑坐标计算说明
  • 克隆
    • 专业数字人克隆
      POST
    • 极速数字人克隆
      POST
    • 声音克隆
      POST
    • 图生数字人克隆
      POST
    • 数字人/声音删除
      DELETE
  • 音频合成
    • 文本转语音
      POST
  • 视频合成
    • 数字人口播视频(无包装)
      POST
    • 智能剪辑模板列表
      GET
    • 数字人口播混剪视频
      POST
    • 真人口播混剪视频
      POST
    • 素材混剪视频
      POST
    • 新闻体视频
      POST
    • 获取模板详情
      GET
    • 自定义数字人口播混剪视频
      POST
    • 自定义素材混剪视频
      POST
    • 自定义真人口播混剪视频
      POST
  • 音频转文字(ASR)
    • 音频转文字(ASR)
  • 图片生成
    • AI封面模板列表
    • AI封面图片生成
  • 公共配音/公共数字人
    • 公共配音列表
    • 公共数字人列表
  • 任务查询
    • 查询任务详情
  • 回调通知
    • 制作类接口回调数据结构
  • 相关协议
    • 用户协议
    • 隐私政策
    • 付费协议
    • 实名协议
  • 数据模型
    • 定制及制作类任务响应
    • 制作任务结果回调数据
    • AI封面
    • 图层数据编辑
    • 图层数据详情
  1. 视频合成

素材混剪视频

POST
/v1/clip/video/broadcast_mixcut

视频生成方式(二选一)

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

  1. 文本内容:字符数要求(3 ~ 1,800字符)
  2. 声音ID:声音定制产生的声音ID

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

音频文件要求:

  • 时长:小于5分钟
  • 格式:mp3、wav、m4a
  • 文件大小:小于等于100MB
  • 需要能够语音转文本

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

包装规则说明

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

音频驱动的audioUrl、素材(materials)的链接、背景音乐的audioUrl、AI封面的resultImageUrl的地址不能重名,重名会导致渲染异常。

素材(materials)要求:

  • 总量限制:单张图片计算为 2秒,所有素材总时长不能超过5分钟;

  • 图片

    • 格式:支持jpg、png、webp静态图
    • 单边分辨率小于2000px
  • 视频

    • 格式:mp4、mov
    • 视频编码:h264、hevc(h265)
    • 帧率:10~60fps,推荐 25
    • 时长:小于60秒
    • 视频大小:单个视频小于500MB
    • 分辨率:单边小于2000px
  • 背景音乐要求:

    • 格式:mp3、wav、m4a
    • 文件大小:<=120MB
    • 时长:<=5分钟

AI封面(imageUrl、resultImageUrl)要求:

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

请求参数

Header 参数

Body 参数application/json

示例
{
    "styleId": "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",
            "soundSwitch": false
        },
        {
            "type": "video",
            "fileUrl": "https://golden-final.com/b.jpg",
            "soundSwitch": 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,
        "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
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/broadcast_mixcut' \
--header 'Authorization: Bearer {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "styleId": "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",
            "soundSwitch": false
        },
        {
            "type": "video",
            "fileUrl": "https://golden-final.com/b.jpg",
            "soundSwitch": 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,
        "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"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "string",
    "data": {
        "taskId": "string"
    },
    "message": "string",
    "requestId": "string"
}
修改于 2026-01-23 10:45:11
上一页
真人口播混剪视频
下一页
新闻体视频
Built with