AI 短剧二创解说--视频点播-火山引擎

文档中心

立即注册

导航

AI 短剧二创解说

最近更新时间：2025.11.06 14:39:24首次发布时间：2025.11.06 14:39:24

本文指导您通过调用视频点播 OpenAPI，实现一站式的“短剧二创解说”视频生成。

功能介绍

短剧二创解说功能可以帮助您轻松为短剧制作解说视频。您只需提供原始视频和解说文案，视频点播会将复杂的剧情分析、文本配音与视频合成流程自动化，为您提供一个强大的内容生产引擎。其核心工作流如下：

剧本还原：深度分析您提供的原始短剧视频，生成结构化的剧本数据。
文本转语音：根据您提供的解说文案和指定的音色，智能生成高质量的旁白配音。
智能音视频合成：将生成的配音与原始视频画面进行智能匹配与合成，并可根据您的配置，擦除原始字幕并添加自定义样式的字幕，最终生成一个全新的、可直接分发的解说视频。

计费说明

短剧二创解说为组合型服务，其总费用由多个底层的原子服务构成。

计费项与单价

计费项	计费规则	单价	服务方
剧本还原	按输入的原始视频时长计费	3 元/分钟	视频点播
解说词与剧情匹配	按输入的原始视频时长计费	0.01 元/分钟	视频点播
解说视频合成	按输出的最终解说视频时长计费	0.39 元/分钟	视频点播
精细化字幕擦除（可选）	按输出的最终解说视频时长计费	4 元/分钟	视频点播
文本转语音 TTS	按输入的解说文案字符数计费	0.0005 元/字符	豆包语音
媒体存储与分发	按标准用量计费		视频点播

说明

文本转语音 TTS 由豆包语音产品提供并计费。此处价格仅供参考，最新价格请以豆包语音计费文档为准。
媒体存储与分发费用指您上传的原始视频、生成的解说视频所产生的存储费用，以及播放这些视频所产生的 CDN 流量费用。具体请参考视频点播计费概述。

计费示例

假设您有一部短剧，希望利用其免费的前 30 集（总时长 60 分钟）作为素材，制作 20 个不同的、每个时长 1 分钟的营销解说短视频。所有视频使用完全一致的解说词和音色（每分钟约 240 字符），并且在生成解说视频时开启了字幕擦除。费用估算如下表所示：

费用分类	计费方式	单价	用量	费用（元）	说明
剧本还原（可多次复用）	按输入视频时长	3 元/分钟	60 分钟	180	对 60 分钟的原始视频进行一次性分析，结果可复用。
解说词与剧情匹配	按输入视频时长	0.01 元/分钟	1200 分钟	12	为 20 个视频进行匹配，每次匹配都基于 60 分钟的原始视频分析结果（20 × 60）。
解说视频合成	按生成视频时长	0.39 元/分钟	20 分钟	7.8	共生成 20 个 1 分钟的视频。
精细化字幕擦除	按生成视频时长	4 元/分钟	20 分钟	80	对 20 个 1 分钟的视频进行字幕擦除。
文本转语音 TTS	按字符数	0.0005 元/字符	240 字符	0.12	解说词和音色完全一致时，仅收取一次文本转语音费用（240 x 0.0005）。
总计	约 280				不含媒体存储与分发费用。

使用限制

请确保您的视频资源满足以下条件：

视频总时长：单次任务处理的所有视频累计时长不超过 90 分钟（约等于一部 45 集的短剧）。
内容类型：适用于真人实拍的短剧、长剧、电影等以人物对话和情节发展为核心的视频内容，不适用于动画、纪录片、广告、直播录屏等缺乏连贯真人剧情或人脸识别线索的视频。
分辨率一致性：提交的多个视频，其分辨率（宽高）必须保持一致。
字幕要求：视频必须包含内嵌字幕（硬字幕）。暂不支持无字幕或外挂字幕的视频。
格式限制：暂不支持 HLS（M3U8）格式的视频源。
存储限制：暂不支持处理挂载在对象存储桶中的视频。

前提条件

已注册火山引擎账号。如果您是首次登录，请先完成实名认证。
已开通视频点播服务。
已创建空间。
开通白名单：使用前请提交工单联系火山引擎技术支持团队申请添加 AI 短剧二创解说和视频智能处理 Aideo Agent 的白名单。
开通视频智能处理 Aideo Agent：前往视频点播控制台开通视频智能处理 Aideo Agent 并完成相关授权。

开通豆包语音服务并获取 APP ID：本功能的配音合成能力由豆包语音服务提供支持。因此，在调用 API 前，您必须完成豆包语音服务的开通与配置，并获取相应的认证与音色信息。具体操作如下：

创建应用并获取 APP ID：请前往豆包语音控制台，创建一个应用，并为该应用开通音频生成大模型。完成后，您将获得 APP ID，这是调用 CreateDramaRecapTask 的必填参数。详细操作步骤，请见豆包语音快速入门。

选择音色模型并获取声音 ID：豆包语音提供两种音频生成大模型，您可以根据业务需求选择其一，并获取对应的 ID：

模型名称	描述	如何获取 ID
语音合成大模型	使用豆包语音提供的多种高质量、多风格的官方预置音色。	您需要获取音色的 VoiceType 字段。请参考官方音色列表进行选择。
声音复刻大模型	使用您自己上传样本并训练生成的专属克隆声音，实现品牌或角色的个性化配音。	您需要获取复刻声音的 speakerid 字段。具体请参考声音复刻文档。

上传视频：通过控制台、客户端上传 SDK、视频点播服务端 SDK 等方式将待处理的短剧视频上传至视频点播服务，并获取到视频的 Vid。具体介绍和操作步骤请见媒资上传概述。

使用流程

步骤 1：提交解说视频生成任务

方式 1：分离式调用（先剧本还原，后解说生成）

此模式分为“剧本还原”与“解说生成”两步。您可以先调用 CreateDramaScriptTask 接口对原始视频进行剧本还原，获得 DramaScriptTaskId。后续，通过这个 DramaScriptTaskId 多次调用 CreateDramaRecapTask 接口，使用不同的解说文案或音色生成多个版本的解说视频。

提交剧本还原任务：调用 CreateDramaScriptTask 接口，对您的原始视频发起一次剧情理解分析。调用成功后，您会获得一个剧本还原任务 ID，即 DramaScriptTaskId。轮询 QueryDramaScriptTask 接口，直至该任务状态变为 success，再进行下一步。

调用 HTTP/HTTPS 接口

集成视频点播服务端 SDK

您可以通过直接调用 HTTP/HTTPS 接口来提交任务。API 请求示例：

POST https://vod.volcengineapi.com?Action=CreateDramaScriptTask&Version=2025-03-03

{
  "SpaceName": "your_space_name",
  "Vids": [
    "vid_episode_01",
    "vid_episode_02"
  ]
}

也可集成视频点播服务端 Java SDK 调用，它封装了签名和请求细节，调用更便捷。示例代码：

package com.volcengine.example.vod.drama;

import com.volcengine.service.vod.IVodService;
import com.volcengine.service.vod.impl.VodServiceImpl;
public class VodCreateDramaScriptTaskDemo {

    public static void main(String[] args) throws Exception {
        // Create a VOD instance in the specified region.
        // IVodService vodService = VodServiceImpl.getInstance("cn-north-1");
        IVodService vodService = VodServiceImpl.getInstance();

        // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641.
        // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed.
        // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account.
        // vodService.setAccessKey("your ak");
        // vodService.setSecretKey("your sk");

        try {
            com.volcengine.service.vod.model.request.VodCreateDramaScriptTaskRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodCreateDramaScriptTaskRequest.newBuilder();
                        reqBuilder.setSpaceName("your SpaceName");
                        reqBuilder.addVids("your Vids");
                        
            com.volcengine.service.vod.model.response.VodCreateDramaScriptTaskResponse resp = vodService.createDramaScriptTask(reqBuilder.build());
            if (resp.getResponseMetadata().hasError()) {
                System.out.println(resp.getResponseMetadata().getError());
                System.exit(-1);
            }
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

提交解说视频生成任务：确认剧本还原任务成功后，调用 CreateDramaRecapTask 接口发起解说视频生成。此时，您需要传入上一步获得的 DramaScriptTaskId，以及用于视频生成的解说文案、音色等配置。调用成功后，您可获得一个解说视频生成任务的 TaskId。

调用 HTTP/HTTPS 接口

集成视频点播服务端 SDK

直接调用 HTTP/HTTPS 接口来提交任务。API 请求示例：

POST https://vod.volcengineapi.com?Action=CreateDramaRecapTask&Version=2025-03-03

{
  "SpaceName": "your_space_name",
  "DramaScriptTaskId": "v02bbbg1006***kbdminbj659kvikr10",
  "RecapText": "今天我们来看一个关于错过的故事...",
  "SpeakerConfig": {
    "AppId": "YOUR_TTS_APPID",
    "VoiceType": "zh_male_magnetic_bigtts"
  },
  "IsEraseSubtitle": true
}

集成视频点播服务端 Java SDK 调用。示例代码：

package com.volcengine.example.vod.drama;

import com.volcengine.service.vod.IVodService;
import com.volcengine.service.vod.impl.VodServiceImpl;
public class VodCreateDramaRecapTaskDemo {

    public static void main(String[] args) throws Exception {
        // Create a VOD instance in the specified region.
        // IVodService vodService = VodServiceImpl.getInstance("cn-north-1");
        IVodService vodService = VodServiceImpl.getInstance();

        // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641.
        // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed.
        // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account.
        // vodService.setAccessKey("your ak");
        // vodService.setSecretKey("your sk");

        try {
            com.volcengine.service.vod.model.request.VodCreateDramaRecapTaskRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodCreateDramaRecapTaskRequest.newBuilder();
                        reqBuilder.setSpaceName("your SpaceName");
                        reqBuilder.setDramaScriptTaskId("your DramaScriptTaskId");
                        reqBuilder.setRecapText("your RecapText");
                        com.volcengine.service.vod.model.business.VodCreateDramaRecapTaskSpeakerConfig.Builder speakerConfigBuilder = com.volcengine.service.vod.model.business.VodCreateDramaRecapTaskSpeakerConfig.newBuilder();
                        reqBuilder.setSpeakerConfig(speakerConfigBuilder);
                        reqBuilder.setIsEraseSubtitle(false);
                        com.volcengine.service.vod.model.business.VodCreateDramaRecapTaskFontconfig.Builder fontConfigBuilder = com.volcengine.service.vod.model.business.VodCreateDramaRecapTaskFontconfig.newBuilder();
                        reqBuilder.setFontConfig(fontConfigBuilder);
                        
            com.volcengine.service.vod.model.response.VodCreateDramaRecapTaskResponse resp = vodService.createDramaRecapTask(reqBuilder.build());
            if (resp.getResponseMetadata().hasError()) {
                System.out.println(resp.getResponseMetadata().getError());
                System.exit(-1);
            }
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

方式 2：一体化调用（一步完成分析与生成）

此模式将两个步骤合二为一，调用更简单。适用于仅需单次生成解说视频、不考虑复用剧本还原结果的便捷场景。您可直接调用 CreateDramaRecapTask 接口，并在请求中直接传入原始短剧视频的 Vids 列表。系统将在后台隐式地先执行剧本还原，再进行解说合成。请求示例：

POST https://vod.volcengineapi.com?Action=CreateDramaRecapTask&Version=2025-03-03

{
  "SpaceName": "your_space_name",
  "Vids": [
    "vid_episode_01",
    "vid_episode_02"
  ],
  "RecapText": "今天我们来看一个关于错过的故事...",
  "SpeakerConfig": {
    "AppId": "YOUR_TTS_APPID",
    "VoiceType": "zh_male_magnetic_bigtts"
  },
  "IsEraseSubtitle": true
}

调用成功后，您也会获得一个解说视频生成任务的 TaskId。

步骤 2：获取生成的解说视频

无论您选择哪种方式提交任务，可通过以下方式获取处理结果：

轮询 QueryDramaRecapTask 接口主动获取结果。

调用 HTTP/HTTPS 接口

集成视频点播服务端 Java SDK

直接调用 HTTP/HTTPS 接口来提交任务。API 请求示例：

GET https://vod.volcengineapi.com?Action=QueryDramaRecapTask&Version=2025-03-03&SpaceName=test&TaskId=v02bbbg1006***kbdminbj659kvikr10

集成视频点播服务端 Java SDK 调用。示例代码：

package com.volcengine.example.vod.drama;

import com.volcengine.service.vod.IVodService;
import com.volcengine.service.vod.impl.VodServiceImpl;
public class VodQueryDramaRecapTaskDemo {

    public static void main(String[] args) throws Exception {
        // Create a VOD instance in the specified region.
        // IVodService vodService = VodServiceImpl.getInstance("cn-north-1");
        IVodService vodService = VodServiceImpl.getInstance();

        // Configure your Access Key ID (AK) and Secret Access Key (SK) in the environment variables or in the local ~/.volc/config file. For detailed instructions, see https://www.volcengine.com/docs/4/65641.
        // The SDK will automatically fetch the AK and SK from the environment variables or the ~/.volc/config file as needed.
        // During testing, you may use the following code snippet. However, do not store the AK and SK directly in your project code to prevent potential leakage and safeguard the security of all resources associated with your account.
        // vodService.setAccessKey("your ak");
        // vodService.setSecretKey("your sk");

        try {
            com.volcengine.service.vod.model.request.VodQueryDramaRecapTaskRequest.Builder reqBuilder = com.volcengine.service.vod.model.request.VodQueryDramaRecapTaskRequest.newBuilder();
                        reqBuilder.setSpaceName("your SpaceName");
                        reqBuilder.setTaskId("your TaskId");
                        
            com.volcengine.service.vod.model.response.VodQueryDramaRecapTaskResponse resp = vodService.queryDramaRecapTask(reqBuilder.build());
            if (resp.getResponseMetadata().hasError()) {
                System.out.println(resp.getResponseMetadata().getError());
                System.exit(-1);
            }
            System.out.println(resp);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

配置事件通知：
1. 参考事件通知概述文档，配置一个用于接收回调的服务地址。在订阅事件时，勾选解说视频生成完成事件。
2. 当任务完成时，您的服务将收到一个 EventType 为 DramaRecapComplete 的 HTTP POST 请求。

当返回结果中的 Status 字段值为 success 时，表示任务已成功完成。您将在 Result 中获得最终生成的解说视频 Vid。至此，您已成功生成短剧解说视频，可以利用获取到的 Vid 进行后续的分发和播放。