媒体处理任务执行完成事件--视频点播-火山引擎

文档中心

视频点播

事件列表

媒体处理任务执行完成事件

本文为您介绍媒体处理任务执行完成事件。

注意事项

若处理的视频文件没有部分格式，那么您接收到的媒体处理任务回调就不会返回相应的参数。

事件类型

ExecutionComplete

事件说明

配置了媒体处理任务执行完成事件通知后，媒体处理任务执行完成时您将收到通知。配置方法详见事件通知概览。关联接口：提交媒体处理任务。

事件内容

参数	类型	示例值	是否必传	说明
RequestId	String	`202405060***0CF1866`	是	请求的唯一 ID
Version	String	`1.0`	是	回调版本
EventType	String	`ExecutionComplete`	是	事件名称
EventTime	String	`2024-05-06T09:49:33Z`	是	事件产生时间，UTC 时间，精度为秒
Data	Data	`-`	是	回调内容，JSON 格式

Data

参数	类型	示例	描述
RunId	String	`lb:75d9a9d137***1f3262fd`	媒体处理任务执行 ID。
Status	String	`Success`	任务状态。取值如下： `Success`：任务成功 `Failed`：任务失败
Code	String	`InvalidParameter.InvalidMediaStream`	任务错误码。具体取值如下： `InvalidParameter.InvalidMediaStream`：解析音视频流失败 `InvalidParameter.MissingMediaStream`：缺少音视频流 `InvalidParameter.InvalidUriError`：用户地址非法 `InvalidParameter.MissingSubtitleStream`：缺少字幕流 `InvalidParameter.InvalidParam`：参数错误 `InvalidParameter.InvalidVidOrUri`：输入源不存在 `InternalError`：内部错误 `InternalError.DownloadError`：系统下载错误 `InternalError.UploadError`：系统上传错误 `InternalError.ExecutionTimeout`：执行超时说明当 `Status` 参数取值为 `Failed` 时，该 `Code` 参数返回具体任务错误码。
Input	Object of Input	`-`	任务输入文件信息。
Meta	Object of ExecutionMeta	`-`	任务元信息。
Control	Object of RuntimeControl	`-`	任务控制配置。
Operation	Object of Operation	`-`	媒体处理操作配置。
Output	Object of Output	`-`	任务输出文件信息。

Input

任务输入文件信息

参数	类型	示例	描述
Type	Sting	`DirectUrl`	输入文件类型。取值如下： `Vid`：Vid 模式。 `DirectUrl`：DirectUrl 模式。 `FileId`：FileId 模式。
Vid	String	`v0dc24***mu6g`	视频 ID。说明仅当 `Type` 取值为 `Vid` 时，返回该参数。
DirectUrl	Object of DirectUrl	`-`	DirectUrl 模式下的文件信息。说明仅当 `Type` 取值为 `DirectUrl` 时，返回该参数。
FileId	Object of FileId	`-`	文件 ID 信息。说明仅当 `Type` 取值为 `FileId` 时，返回该参数。

DirectUrl

DirectUrl 模式下的文件信息

参数	类型	示例	描述
BucketName	String	`tos-vod--v-36***41`	空间所绑定的存储桶名称。
FileName	String	`94d97***165a4ff`	文件路径。
SpaceName	String	`test`	点播空间名称。

FileId

文件 ID 信息

参数	类型	示例值	描述
Vid	String	`v0ccfeg7007acsg***fog65ubr7niqng`	视频 ID。
FileId	String	`v02b69g10***ldb8vjafvmg`	文件 ID。

ExecutionMeta

任务元信息

参数	类型	示例	描述
SpaceName	String	`test`	点播空间名称。
Trigger	String	`API`	任务来源。取值如下： `API`：调用接口触发 `AutoTrigger`：上传自动触发 `TranscodeStrategy`：转码策略触发
CreateTime	String	DynamicRange	任务创建时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。
StartTime	String	`2025-01-14T09:13:07Z`	任务开始时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。
EndTime	String	`2025-01-14T09:17:35Z`	任务结束时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。

RuntimeControl

任务控制配置

参数	类型	示例	描述
CallbackArgs	String	`Example`	您在提交媒体处理任务时设置的自定义信息。仅当您在提交媒体处理任务时设置了 `CallbackArgs` 参数时返回。
Priority	Int32	`1`	任务优先级。默认值为 0。取值范围为 [-5,5]。数字越小，优先级越高。
EnableLowPriority	Boolean	`false`	是否开启闲时任务。取值如下： `true`：开启 `false`：关闭
ClientToken	String	QqS3o5L4BLFCDxGZ&b	用户请求凭证，用于区分不同请求。仅当您在提交媒体处理任务时设置了 `ClientToken` 参数时返回。

Operation

媒体处理操作配置。

参数	类型	示例	描述
Type	String	`Template`	处理类型。取值如下： `Template`：单模板任务。 `Task`：单任务。
Template	Object of OperationTemplate	`-`	模板任务配置。当 `Type` 为 `Template` 时返回该参数。
Task	Object of Task	`-`	单任务配置。当 `Type` 为 `Task` 时返回该参数。

参数

类型

示例

描述

Type

String

Template

处理类型。取值如下：

Template：单模板任务。
Task：单任务。

Template

Object of OperationTemplate

-

模板任务配置。当 Type 为 Template 时返回该参数。

Task

Object of Task

-

单任务配置。当 Type 为 Task 时返回该参数。

OperationTask

单任务配置

参数	类型	示例值	描述
Type	String	`Highlight`	任务类型： `Highlight`: 高光分析任务。 `AdAudit`: 巨量广告预审任务。 `AudioExtract`: 人声背景音分离任务。 `Vision`: 视频理解任务。 `Asr`: ASR 语音转写任务。 `Storyline`: 故事线分析任务。 `Segment`: 场景切分任务。 `Ocr`: OCR 文本识别任务。 `Erase`: 精细化字幕擦除任务。 `FileDelete`: 文件删除任务。 `VideoSummary`: 视频分段摘要任务。 `VideoGeneration`：视频生成任务。
Highlight	Object of OperationTaskHighlight	`-`	高光分析任务配置。
Vision	Object of OperationTaskVision	`-`	大模型视频理解任务配置。
AdAudit	Object of OperationTaskAdAudit	`-`	巨量广告预审任务配置。
AudioExtract	Object of OperationTaskAudioExtract	`-`	音频分离任务配置。
Asr	Object of OperationTaskAsr	`-`	语音转写任务配置。
Storyline	Object of OperationTaskStoryline	`-`	故事线分析任务配置。
Segment	Object of OperationTaskSegment	`-`	场景切分任务配置。
Erase	Object of OperationTaskErase	`-`	精细化字幕擦除任务配置。

OperationTaskHighlight

参数	类型	示例值	描述
Mode	String	`Clips`	高光分析任务的模式： `Clips`：（默认）高光片段模式。 `StorylineCuts`：（推荐）故事线混剪模式，在高光片段模式基础上融入故事线信息。
OpeningHook	Object of OperationTaskHighlightOpeningHook	`-`	精彩前置功能配置。开启精彩前置功能后，系统将自动分析并提取视频中最精彩的片段，将其置于视频开头，以吸引观众。仅当 `Mode` 为 `StorylineCuts`时生效。
HighlightCuts	Object of OperationTaskHighlightCuts	`-`	高光片段配置。仅当 `mode` 取值为 `StorylineCuts` 时生效。
StorylineCuts	Object of OperationTaskHighlightStorylineCuts	`-`	故事线混剪配置。仅当 `mode` 取值为 `StorylineCuts`时生效。

OperationTaskVision

大模型视频理解任务配置

参数	类型	示例值	描述
Prompt	String	`请根据输入的视频抽帧图片信息以及音频转译文本，撰写视频内容梗概。要求涵盖视频主要情节、关键人物以及核心事件，语言简洁流畅，逻辑清晰。`	大模型提示词。
Model	Object of OperationTaskVisionModel	`-`	大模型配置。

OperationTaskAdAudit

巨量广告预审任务配置

参数	类型	示例值	描述
AdvertiserId	String	`18202155***64928`	广告主 ID。
BusinessType	String	`ad`	广告投放渠道： `ad`：巨量广告 `qianchuan`：巨量千川 `local_life`：巨量本地推

参数

类型

示例值

描述

AdvertiserId

String

18202155***64928

广告主 ID。

BusinessType

String

ad

广告投放渠道：

ad：巨量广告
qianchuan：巨量千川
local_life：巨量本地推

OperationTaskAudioExtract

音频分离任务

参数	类型	示例值	描述
Voice	Boolean	`true`	是否提取人声。

OperationTaskAsr

语音转写任务配置

参数	类型	示例值	描述
Type	String	`speech`	识别类型，取值如下： `speech`: 对话 `singing`: 歌唱
Language	String	`cmn-Hans-CN`	识别提示语言，取值如下： `cmn-Hans-CN`: 简体中文 `cmn-Hant-CN`: 繁体中文 `eng-US`: 英语 `jpn-JP`: 日语 `kor-KR`: 韩语 `rus-RU`: 俄语 `fra-FR`: 法语 `por-PT`: 葡萄牙语 `spa-ES`: 西班牙语 `vie-VN`: 越南语 `mya-MM`: 缅甸语 `nld-NL`: 荷兰语 `deu-DE`: 德语 `ind-ID`: 印尼语 `ita-IT`: 意大利语 `pol-PL`: 波兰语 `tha-TH`: 泰语 `tur-TR`: 土耳其语 `ara-SA`: 阿拉伯语 `msa-MY`: 马来语 `ron-RO`: 罗马尼亚语 `fil-PH`: 菲律宾语 `hin-IN`: 印地语
WithSpeakerInfo	Boolean	`true`	是否开启使说话人识别功能。开启后，会通过返回参数 `speaker` 返回说话人信息。
WithConfidence	Boolean	`true`	是否返回置信度。如为 `true`，会通过返回参数 `Confidence` 返回置信度。

OperationTaskStoryline

故事线分析任务配置

参数	类型	示例值	描述
WithSnapshot	Boolean	`true`	是否开启视频截图。

OperationTaskErase

精细化字幕擦除任务配置

参数	类型	示例值	描述
Mode	String	`Auto`	字幕擦除模式，取值如下： `Auto`：自动擦除模式。在此模式下，系统将启用 OCR 识别，并依据检测结果进行擦除操作。 `Manual`：手动擦除模式。在此模式下，系统不会启用 OCR 识别，仅擦除白色字幕内容。
Auto	Object of OperationTaskEraseAuto	`-`	自动擦除模式配置
Manual	Object of OperationTaskEraseManual	`-`	手动擦除模式配置
WithEraseInfo	Boolean	`true`	是否返回擦除信息详情

OperationTaskSegment

场景切分任务配置

参数	类型	示例值	描述
NoFile	Boolean	`true`	是否生成切片文件： `true`: 不生成切片文件 `false`:（默认）生成切片文件

参数

类型

示例值

描述

NoFile

Boolean

true

是否生成切片文件：

true: 不生成切片文件
false:（默认）生成切片文件

OperationTaskHighlightStorylineCuts

故事线混剪配置

参数	类型	示例值	描述
MinDuration	Double	`10`	输出高光片段的最短时长，单位为秒，默认大于 0。
MaxDuration	Double	`60`	输出高光片段的最大时长，单位为秒。默认由算法自动判断。若用户指定最大时长，则会将混剪结果截断至合适长度，可能不会使用全部输入视频片段。
MaxNumber	Double	`5`	输出高光片段的最多片段数，默认为 1。

OperationTaskVisionModel

参数	类型	示例值	描述
DoubaoVisionEndpoint	String	`ep-202412***75335-cg2p7`	豆包 Doubao-vision 模型的推理接入点 ID。
AsrAppId	String	`3500***054`	语音识别 (ASR) 产品的 APP ID。
AsrAppType	String	`volc.bigasr.sauc.duration`	语音识别 (ASR) 产品中流式语音识别大模型的类型，取值如下： `volc.bigasr.sauc.duration`: 小时版 `volc.bigasr.sauc.concurrent`: 并发版

参数

类型

示例值

描述

DoubaoVisionEndpoint

String

ep-202412***75335-cg2p7

豆包 Doubao-vision 模型的推理接入点 ID。

AsrAppId

String

3500***054

语音识别 (ASR) 产品的 APP ID。

AsrAppType

String

volc.bigasr.sauc.duration

语音识别 (ASR) 产品中流式语音识别大模型的类型，取值如下：

volc.bigasr.sauc.duration: 小时版
volc.bigasr.sauc.concurrent: 并发版

OperationTaskEraseAuto

参数	类型	示例值	描述
Type	String	`Subtitle`	文本擦除类型: `Subtitle`: 擦除 OCR 检测为字幕的文本 `Text`: 擦除除场景文字（如宫殿门牌匾等）以外的字幕及其他文本（如人物介绍等）。
Locations	Array of OperationTaskEraseLocation	`-`	擦除框数组。添加擦除框后，系统仅擦除框内文本。

参数

类型

示例值

描述

Type

String

Subtitle

文本擦除类型:

Subtitle: 擦除 OCR 检测为字幕的文本
Text: 擦除除场景文字（如宫殿门牌匾等）以外的字幕及其他文本（如人物介绍等）。

Locations

Array of OperationTaskEraseLocation

-

擦除框数组。添加擦除框后，系统仅擦除框内文本。

OperationTaskEraseManual

参数	类型	示例值	描述
Locations	Array of OperationTaskEraseLocation	`-`	擦除框数组。添加擦除框后，系统仅擦除框内文本。

OperationTemplate

单模板任务配置

参数	类型	示例	描述
Type	String	`TranscodeVideo`	单模板任务类型。取值如下： `TranscodeVideo`：视频转码模板任务。 `ByteHD`：极智超清模板任务。 `TranscodeAudio`：音频转码模板任务。 `Enhance`：画质增强模板任务。
TranscodeVideo	Object of OperationTemplateTranscodeVideo	`-`	视频转码模板任务配置。仅当 `Type` 取值为 `TranscodeVideo` 时，返回该参数。
ByteHD	Object of OperationTemplateByteHD	`-`	极智超清模板任务配置。仅当 `Type` 取值为 `ByteHD` 时，返回该参数。
TranscodeAudio	Object of OperationTemplateTranscodeAudio	`-`	音频转码模板任务配置。仅当 `Type` 取值为 `TranscodeAudio` 时，返回该参数。
Enhance	Object of OperationTemplateEnhance	`-`	画质增强模板任务配置。仅当 `Type` 取值为 `Enhance` 时，返回该参数。

OperationTemplateTranscodeVideo

视频转码模板任务配置

参数	类型	示例	描述
TemplateId	String	`ddc7d66386***6056a`	视频转码模板 ID。
WatermarkTemplateId	String	`v0dc24g10***c1cepmu6g`	水印模板 ID。

OperationTemplateByteHD

极智超清模板任务配置

参数	类型	示例	描述
TemplateId	String	`ddc66386***6056a`	极智超清模板 ID。
WatermarkTemplateId	String	`v0dc24g10***c1cepmu6g`	水印模板 ID。

OperationTemplateTranscodeAudio

音频转码模板任务配置

参数	类型	示例	描述
TemplateId	String	`ddc76386***6056a`	音频转码模板 ID。

OperationTemplateEnhance

画质增强模板任务配置

参数	类型	示例	描述
TemplateId	String	`ddc7d66386***56a`	画质增强模板 ID。

Output

任务输出文件信息

参数	类型	示例	描述
Type	String	`Template`	任务类型： `Task`：单任务输出结果。 `Template`：单模板任务输出结果。
Template	Object of OutputTemplate	`-`	单模板任务输出结果。
Task	Object of OutputTask	`-`	单任务输出结果。

参数

类型

示例

描述

Type

String

Template

任务类型：

Task：单任务输出结果。
Template：单模板任务输出结果。

Template

Object of OutputTemplate

-

单模板任务输出结果。

Task

Object of OutputTask

-

单任务输出结果。

OutputTask

单任务输出结果

参数	类型	示例值	描述
Type	String	`Highlight`	任务类型： `Highlight`: 高光分析任务。 `AdAudit`: 巨量广告预审任务。 `AudioExtract`: 音频分离任务。 `Vision`: 大模型视频理解任务。 `Asr`: 语音转写任务。 `Storyline`: 故事线分析任务。 `Segment`: 场景切分任务。
Highlight	Object of OutputTaskHighlight	`-`	高光分析任务输出结果。
AudioExtract	Object of OutputTaskAudioExtract	`-`	音频分离任务输出结果。
Vision	Object of OutputTaskVision	`-`	大模型视频理解任务输出结果。
AdAudit	Object of OutputTaskAdAudit	`-`	巨量广告预审任务输出结果。
Storyline	Object of OutputTaskStoryline	`-`	故事线分析任务输出结果。
Asr	Object of OutputTaskAsr	`-`	语音转写任务输出结果。
Segment	Object of OutputTaskSegment	`-`	场景切分任务输出结果。
Erase	Object of OutputTaskErase	`-`	精细化字幕擦除任务输出结果。

OutputTaskHighlight

高光分析任务输出结果

参数	类型	示例值	描述
Duration	Double	`75.093333`	输入视频总时长，单位为秒。
Clips	Array of HighlightClip	`-`	高光片段信息，当请求参数 `Highlight.Mode` 为 `Clips` （高光片段模式）时返回。
StorylineCuts	Object of OutputTaskHighlightStorylineCuts	`-`	混剪信息，当请求参数 `Highlight.Mode` 为 `StorylineCuts`（混剪）模式时返回。

OutputTaskAudioExtract

音频分离任务输出结果

参数	类型	示例值	描述
Duration	Double	`152.085`	视频时长，单位为秒。
Voice	Object of MediaFileInfo	`-`	人声文件信息。
Background	Object of MediaFileInfo	`-`	剥离人声后的背景声文件信息。

OutputTaskVision

大模型视频理解任务输出结果

参数	类型	示例值	描述
Duration	Double	`70.1`	视频时长，单位为秒。
SnapshotsNumber	Integer	`50`	截图张数。
Model	Object of OutputTaskVisionModelUsage	`-`	视频理解任务大模型用量。
Content	String	`视频展示的是xxx。以下是视频的具体内容xxx`	视频理解结果。

OutputTaskAdAudit

巨量广告预审任务输出结果

参数	类型	示例值	描述
Status	String	`AuditResult__PASS`	审核状态： `AuditResult__PASS`: 审核通过 `AuditResult__REJECT`: 审核不通过
Code	Integer	`1000127`	拒绝码。内部参数，暂不生效。
Reason	String	`您好，素材中不得涉及虚假宣传或误导用户的内容xxx`	审核建议。
Label	Array of Integer	`["10139"]`	审核流控标。内部参数，暂不生效。
Duration	Double	`152.085`	视频时长，单位为秒。

OutputTaskStoryline

故事线分析任务输出结果

参数	类型	示例值	描述
Duration	Double	`1801.1`	输入视频总时长，单位为秒。
Summaries	Array of String	`-`	每个视频的简介。
AllTags	Array of OutputTaskStorylineTags	`-`	每个视频的标签。
Storylines	Array of OutputTaskStorylineItem	`-`	高光片段信息。
Clips	Array of OutputTaskStorylineClip	`-`	视频片段信息。

OutputTaskAsr

语音转写任务输出结果

参数	类型	示例值	描述
Duration	Double	`70.1`	视频时长，单位为秒。
Confidence	Double	`Float`	置信度。
Utterances	Array of Utterance	`-`	声音信息。

OutputTaskSegment

场景切分任务输出结果

参数	类型	示例值	描述
Duration	Double	`70.1`	视频时长，单位为秒。
Segments	Array of OutputTaskSegmentItem	`-`	视频切片信息。

OutputTaskErase

精细化字幕擦除任务输出结果

参数	类型	示例值	描述
Duration	Double	`152.085`	输出视频时长，单位为秒。
File	Object of MediaFileInfo	`-`	输出文件信息
Info	Object of OutputTaskEraseInfo	`-`	擦除详细信息，仅当调用 `StartExecution` 接口时将 `Erase.WithEraseInfo` 设为 `true` 才返回。

HighlightClip

高光片段信息

参数	类型	示例值	描述
Start	Double	`0.52`	高光片段开始时间，单位为秒。
End	Double	`3.52`	高光片段结束时间，单位为秒。

OutputTaskHighlightStorylineCuts

参数	类型	示例值	描述
Segments	Array of OutputTaskHighlightSegment	`-`	视频片段信息。算法会基于分镜理解分析输出视频片段，包含的信息最为全面。
Storylines	Array of OutputTaskHighlightStoryline	`-`	故事线信息。算法会将 `segments` 中属于同一故事情节的部分整理成连贯的故事线。
CutSegments	Array of OutputTaskHighlightCutSegments	`-`	算法根据 `StartExecution` 接口请求参数 `StorylineCuts` 中输入的条件限制，从故事线中提取最精彩的片段。若请求参数中没有条件限制，则默认剔除视频中高光分数 ≤1 以及 1 < 高光分数 ≤2 且无台词的片段。

MediaFileInfo

媒体文件信息

参数	类型	示例值	描述
Size	String	`2519064`	文件大小，单位为字节。
FileName	String	`9c78b9bbb841***586252231dadc9422_speech.aac`	文件路径。

OutputTaskVisionModelUsage

视频理解任务大模型用量

参数	类型	示例值	描述
DoubaoInputTokens	Integer	`2564`	豆包输入令牌数量。
DoubaoOutputTokens	Integer	`528`	豆包输出令牌数量。
DoubaoTotalTokens	Integer	`3092`	豆包总计令牌数量。

OutputTaskStorylineTags

故事线分析任务视频标签

参数	类型	示例值	描述
Tags	Array of String	`刑侦追凶`	视频标签。

OutputTaskStorylineItem

故事线分析任务高光片段信息

参数	类型	示例值	描述
Title	String	`雨夜少女遇害案发`	高光片段标题。
Summary	String	`-`	高光片段简介。
Clips	Array of Integer	`[0, 1, 2, 3, 4, 5, 6]`	高光片段索引。假设此字段为 `[0, 1, 2]`，对应 `Clips` 中的第 0、1、2 个片段。

OutputTaskStorylineClip

故事线分析任务视频片段信息

参数	类型	示例值	描述
VideoIndex	Integer	`0`	输入视频标识，用以指明该片段源自哪个输入视频，编号从 0 开始。
Title	String	`雨夜少女遇害案发`	视频片段标题。
Summary	String	`2002年雨夜发生恶性xxx`	视频片段简介。
Snapshot	String	`uuid/0.jpg`	截图的文件路径 FileName。
Score	Double	`3.5`	高光值，取值范围为 [1,5]。
Dialogue	String	`对话`	视频对话。
Start	Double	`133.0`	片段开始时间，单位为秒。
End	Double	`181.0`	片段结束时间，单位为秒。

Utterance

声音信息

参数	类型	示例值	描述
Attribute	Object of UtteranceAttribute	`-`	声音属性。
Text	String	`火山引擎视频云`	识别的文本信息。
Start	Double	`13.88`	开始时间，单位为秒。
End	Double	`15.88`	结束时间，单位为秒。

OutputTaskSegmentItem

场景切分任务视频切片信息。

参数	类型	示例值	描述
Start	Double	`0`	切片开始时间，单位为秒。
End	Double	`1.41`	切片结束时间，单位为秒。
Frames	Array of Integer	`[0, 84]`	开始帧和结束帧。
File	Object of MediaFileInfo	`-`	切片文件。

OutputTaskEraseInfo

参数	类型	示例值	描述
Width	Integer	`1920`	擦除后视频的宽度，单位为像素。
Height	Integer	`1080`	擦除后视频的高度，单位为像素。
Areas	Array of OutputTaskEraseArea	`-`	擦除区域信息

OperationTaskEraseLocation

参数	类型	示例值	描述
RatioLocation	Object of RatioRectangle	`-`	擦除框位置信息。详细介绍，请见提交精细化字幕擦除任务。

OutputTaskHighlightSegment

高光分析输出视频片段信息。

参数	类型	示例值	描述
Start	Double	`133.0`	片段开始时间，单位为秒。
End	Double	`181.0`	片段结束时间，单位为秒。
Score	Double	`3.5`	高光值，取值范围为 [1,5]。
Ocr	String	`字幕`	字幕 OCR 识别。仅识别位于画面下半部分且居中的字幕。
Description	String	`描述`	画面描述。
Location	String	`公司`	地点标签。
Shot	String	`特写`	景别标签： `特写`: 面部或细节 `近景`: 胸部以上 `中景`: 腰部以上 `全景`: 全身 `远景`: 环境为主
VideoIndex	Integer	`0`	输入视频标识，用以指明该片段源自哪个输入视频，编号从 0 开始。

OutputTaskHighlightStoryline

高光分析输出故事线信息。

参数	类型	示例值	描述
Title	String	`标题`	标题
Description	String	`描述`	描述
Score	Double	`3.5`	高光值，取值范围为 [1,5]
Segments	Array of Integer	`[0,1,2]`	片段索引信息

OutputTaskHighlightCutSegments

参数	类型	示例值	描述
Segments	Array of Integer	`[0,1,2]`	片段索引信息

UtteranceAttribute

声音属性

参数

类型

示例值

描述

Confidence

Double

0.914009673595429

置信度。

Event

String

speech

识别类型，取值如下：

speech: 对话
singing: 歌唱

Speaker

String

1

识别的说话人。

OutputTaskEraseArea

参数	类型	示例值	描述
Start	Double	`13.88`	开始时间，单位为秒。
End	Double	`15.88`	结束时间，单位为秒。
PixelRectangle	Array of PixelRectangle	`-`	擦除区域位置信息

RatioRectangle

参数	类型	示例值	描述
TopLeftX	Double	`0`	擦除框左上角相对于视频左上角在 X 轴上的偏移，取值范围为 [0,1]。
TopLeftY	Double	`0`	擦除框左上角相对于视频左上角在 Y 轴上的偏移，取值范围为 [0,1]。
BottomRightX	Double	`0`	擦除框右下角相对于视频左上角在 X 轴上的偏移，取值范围为 [0,1]。
BottomRightY	Double	`0`	擦除框右下角相对于视频左上角在 Y 轴上的偏移，取值范围为 [0,1]。

PixelRectangle

参数	类型	示例值	描述
TopLeftX	Integer	`108`	擦除区域左上角相对于视频左上角在 X 轴上的偏移，单位为像素
TopLeftY	Integer	`960`	擦除区域左上角相对于视频左上角在 Y 轴上的偏移，单位为像素
BottomRightX	Integer	`1067`	擦除区域右下角相对于视频左上角在 X 轴上的偏移，单位为像素
BottomRightY	Integer	`1919`	擦除区域右下角相对于视频左上角在 Y 轴上的偏移，单位为像素

OutputTemplate

单模板任务输出结果

参数	类型	示例	描述
Type	String	`TranscodeVideo`	单模板任务类型。取值如下： `TranscodeVideo`：视频转码模板任务。 `ByteHD`：极智超清模板任务。 `TranscodeAudio`：音频转码模板任务。 `Enhance`：画质增强模板任务。
TranscodeVideo	Object of VodTranscodeInfo	`-`	视频转码模板任务输出。仅当 `Type` 取值为 `TranscodeVideo` 时，返回该参数。
ByteHD	Object of VodTranscodeInfo	`-`	极智超清模板任务输出。仅当 `Type` 取值为 `ByteHD` 时，返回该参数。
TranscodeAudio	Object of VodTranscodeInfo	`-`	音频转码模板任务输出。仅当 `Type` 取值为 `TranscodeAudio` 时，返回该参数。
Enhance	Object of VodTranscodeInfo	`-`	画质增强模板任务输出。仅当 `Type` 取值为 `Enhance` 时，返回该参数。

VodTranscodeInfo

媒体处理产物信息

参数	类型	示例	描述
FileId	String	`67410***500548c`	文件 ID。
Md5	String	`4d4a***803b23e`	文件 MD5 值。
FileType	String	`video`	文件类型。取值如下： `video`：非加密视频 `audio`：非加密音频 `private_evideo`: 私有加密视频（新版） `private_eaudio`: 私有加密音频（新版） `standard_evideo`: HLS 标准加密视频 `standard_eaudio`: HLS 标准加密音频 `evideo`：加密视频（旧版） `eaudio`：加密音频（旧版）
LogoType	String	`aa`	水印贴片标签。即您在视频点播控制台创建水印贴片模板时配置的自定义水印贴片标签，详见水印贴片模板。
Encrypt	Boolean	`true`	是否加密。取值如下： `true`：加密。 `false`：不加密。
Format	String	`HLS`	编码格式。取值如下：视频转码：MP4、Dash、HLS、FLV、TS 音频转码：MP3、M4A、MP4、Dash、HLS、OGG
Size	Integer	`1449027`	文件大小，单位为字节。
Duration	Float	`10.04`	转码流时长，单位为秒。
StoreUri	String	`tos-vod--v-3***b28/main.m3u8`	文件存储地址。
DynamicRange	String	`SDR`	动态范围。取值如下： `HDR`：高动态范围 `SDR`：标准动态范围
TosStorageClass	String	`STANDARD`	媒资存储类型。取值如下： `STANDARD`：标准存储 `ARCHIVE`：归档存储 `IA`：低频存储
CreateTime	String	`2024-06-04 17:17:55`	文件创建时间。
VideoStreamMeta	Object of VideoStreamMeta	`-`	视频流信息。
AudioStreamMeta	Object of AudioStreamMeta	`-`	音频流信息。

VideoStreamMeta

视频流元信息

参数	类型	示例值	描述
Codec	String	`h265`	视频编码格式。
Height	Integer	`1080`	视频高度，单位为 px。
Width	Integer	`1920`	视频宽度，单位为 px。
Duration	Float	`10.04`	视频时长，单位为秒。
Definition	String	`2k`	视频清晰度。
Bitrate	Integer	`967525`	视频码率，单位为 bps。
Fps	Float	`25`	视频帧率，单位为 fps。

AudioStreamMeta

音频流元信息

参数	类型	示例值	描述
Codec	String	`aac`	音频编码格式。
Duration	Float	`10.027`	音频时长，单位为秒。
SampleRate	Integer	`44100`	音频采样率。
Bitrate	Integer	`128989`	音频码率，单位为 bps。
Quality	String	`higher`	音频质量。取值如下： `higher`：高音质。 `highest`：音乐音质。 `medium`：普通音质。

回调示例

视频转码模板任务执行完成

{
   "Data":{
      "Input":{
         "DirectUrl":{
            "BucketName":"tos-vod--v-3640747e9e4afe41",
            "FileName":"94d97c9f03***f34a93165a4ff",
            "SpaceName":"test"
         },
         "Type":"DirectUrl"
      },
      "Meta":{
         "SpaceName":"test",
         "Trigger":"API"
      },
      "Operation":{
         "Template":{
            "TranscodeVideo":{
               "TemplateId":"ddc7d66386b***e4fb2071bb6056a"
            },
            "Type":"TranscodeVideo"
         },
         "Type":"Template"
      },
      "Output":{
         "Template":{
            "TranscodeVideo":{
               "AudioStreamMeta":{
                  "Bitrate":128989,
                  "Codec":"aac",
                  "Duration":10.027,
                  "Quality":"higher",
                  "SampleRate":44100
               },
               "CreateTime":"2024-06-04 17:17:55",
               "Duration":10.04,
               "DynamicRange":"SDR",
               "Encrypt":true,
               "FileId":"674107521e***490069228d500548c",
               "FileType":"Video",
               "Format":"HLS",
               "Md5":"4d4ad573234e***bff46803b23e",
               "Size":1449027,
               "StoreUri":"tos-vod--v-3640747e9e4afe41/752ac7b3***049b25224eafcc76b28/main.m3u8",
               "TosStorageClass":"STANDARD",
               "VideoStreamMeta":{
                  "Bitrate":967525,
                  "Codec":"h265",
                  "Definition":"2k",
                  "Duration":10.04,
                  "Fps":25,
                  "Height":1080,
                  "Width":1920
               }
            },
            "Type":"TranscodeVideo"
         },
         "Type":"Template"
      },
      "RunId":"lb:75d9a9d137a***4301d7fd91f3262fd",
      "Status":"Success"
   },
   "EventTime":"2024-06-04T09:17:55Z",
   "EventType":"ExecutionComplete",
   "RequestId":"2024060417***D2F812BACCB228AC3",
   "Version":"1.0"
}

高光分析任务执行完成

{
    "Data": {
        "Input": {
            "DirectUrl": {
                "BucketName": "tos-vod--v-3640747e9e4afe41",
                "FileName": "94d97c9f03***f34a93165a4ff",
                "SpaceName": "test"
            },
            "Type": "DirectUrl"
        },
        "Meta": {
            "SpaceName": "test",
            "Trigger": "API"
        },
        "Operation": {
            "Type": "Task",
            "Task": {
                "Type": "Highlight",
                "Highlight": {}
            }
        },
        "Output": {
            "Type": "Task",
            "Task": {
                "Type": "Highlight",
                "Highlight": {
                    "Duration": 75.093333,
                    "Clips": [
                        {
                            "Start": 0.52,
                            "End": 5.32
                        },
                        {
                            "Start": 13.04,
                            "End": 30.88
                        },
                        {
                            "Start": 39.76,
                            "End": 75
                        }
                    ]
                }
            }
        },
        "RunId": "lb:75d9a9d137a***4301d7fd91f3262fd",
        "Status": "Success"
    },
    "EventTime": "2024-06-04T09:17:55Z",
    "EventType": "ExecutionComplete",
    "RequestId": "2024060417***D2F812BACCB228AC3",
    "Version": "1.0"
}

最近更新时间：2025.10.09 14:49:36

这个页面对您有帮助吗？

有用

无用

视频点播

Data #

Input #

DirectUrl #

FileId #

ExecutionMeta #

RuntimeControl #

Operation #

OperationTask #

OperationTaskHighlight

OperationTaskVision

OperationTaskAdAudit

OperationTaskAudioExtract

OperationTaskAsr

OperationTaskStoryline

OperationTaskErase

OperationTaskSegment

OperationTaskHighlightStorylineCuts

OperationTaskVisionModel

OperationTaskEraseAuto

OperationTaskEraseManual

OperationTemplate #

OperationTemplateTranscodeVideo

OperationTemplateByteHD

OperationTemplateTranscodeAudio

OperationTemplateEnhance

Output #

OutputTask #

OutputTaskHighlight

OutputTaskAudioExtract

OutputTaskVision

OutputTaskAdAudit

OutputTaskStoryline

OutputTaskAsr

OutputTaskSegment

OutputTaskErase

HighlightClip

OutputTaskHighlightStorylineCuts

MediaFileInfo

OutputTaskVisionModelUsage

OutputTaskStorylineTags

OutputTaskStorylineItem

OutputTaskStorylineClip

Utterance

OutputTaskSegmentItem

OutputTaskEraseInfo

OperationTaskEraseLocation

OutputTaskHighlightSegment

OutputTaskHighlightStoryline

OutputTaskHighlightCutSegments

UtteranceAttribute

OutputTaskEraseArea

RatioRectangle

PixelRectangle

OutputTemplate #

VodTranscodeInfo

VideoStreamMeta

AudioStreamMeta

回调示例 #

视频转码模板任务执行完成 #

高光分析任务执行完成 #

Data

Input

DirectUrl

FileId

ExecutionMeta

RuntimeControl

Operation

OperationTask

OperationTemplate

Output

OutputTask

OutputTemplate

回调示例

视频转码模板任务执行完成

高光分析任务执行完成