本文档介绍视频字幕擦除EraseVideoSubtitles的语法及示例。

功能描述

EraseVideoSubtitles可以擦除视频中的标准字幕，如电影电视剧中下方的白色字幕。

前提条件

请确保您已开通视频生产服务，若未开通服务请立即开通。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 EraseVideoSubtitles

要执行的操作。取值：EraseVideoSubtitles。
VideoUrl String 是 http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4

输入视频URL。URL地址中不能包含中文字符。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

BX Float 否 0

字幕区域左上角点x坐标/视频宽度，取值0~1。
BY Float 否 0.75

字幕区域左上角点y坐标/视频高度，取值0~1。
BW Float 否 1

字幕区域的宽度/视频宽度，取值0~1。
BH Float 否 0.25

字幕区域的高度/视频高度，取值0~1。
说明 bx、by、bw、bh，定义一个字幕区域，只有字幕区域内的字幕会被擦除，默认视频下方区域：（bx=0,by=0.75,bw=1,bh=0.25）。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
VideoUrl String http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4

输出处理后的视频URL地址。
RequestId String CCB082BF-A6B1-4C28-9E49-562EEE7DE639

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=EraseVideoSubtitles
&VideoUrl=http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4
&<公共请求参数>

正常返回示例

XML 格式 

<RequestId>CCB082BF-A6B1-4C28-9E49-562EEE7DE639</RequestId>
<Data>
    <VideoUrl>http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4</VideoUrl>
</Data>

JSON 格式 

{
    "RequestId": "CCB082BF-A6B1-4C28-9E49-562EEE7DE639",
    "Data": {
        "VideoUrl": "http://public-vigen-video.oss-cn-shanghai.aliyuncs.com/zhuxun.lx/test1.mp4"
    }
}

查询任务结果

该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。具体请参见GetAsyncJobResult。

错误码

具体请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。