真人口播混剪视频

包装规则说明

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

如果您期望生成的视频关闭标题显示、关闭字幕显示等，请在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": "头"
}]

真人口播视频（videoUrl）要求：

• 格式：mp4、mov

• 视频编码：h264

• 帧率：20～30fps，推荐 25

• 时长：小于5分钟

• 视频大小：小于500MB

• 分辨率：单边小于2000px

• 视频中的音频需要能够语音转文本

素材（materials）要求：

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

图片

格式：支持jpg、png、webp静态图

单边分辨率小于2000px

视频

格式：mp4、mov

视频编码：h264

帧率：20～30fps，推荐 25

时长：小于60秒

视频大小：单个视频小于100MB

分辨率：单边小于2000px

请求参数

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",
        "materialMatchWay": "fuzzyMatch",
       "metadata": {
        "AIGC": "{\"Label\":\"1\",\"ContentProducer\":\"AI服务提供者的名称或统一社会信用代码等\",\"ProduceID\":\"XXXXXXXXXXXXXXXXXXX\"}"
    }
    },
    "subtitles": [
        {
            "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": "业"
        }
    ],
    "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/realman_broadcast' \
--header 'Authorization;' \
--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",
        "materialMatchWay": "fuzzyMatch",
       "metadata": {
        "AIGC": "{\"Label\":\"1\",\"ContentProducer\":\"AI服务提供者的名称或统一社会信用代码等\",\"ProduceID\":\"XXXXXXXXXXXXXXXXXXX\"}"
    }
    },
    "subtitles": [
        {
            "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": "业"
        }
    ],
    "callbackUrl": "https://exotic-reservation.org/hook"
}'

包装规则说明#

特殊字段说明#

真人口播视频（videoUrl）要求：#