You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/API 参考/媒体处理/GetExecution - 获取媒体处理任务执行结果
GetExecution - 获取媒体处理任务执行结果
最近更新时间：2025.04.10 11:12:52首次发布时间：2025.03.11 21:22:49
我的收藏
有用
有用
无用
无用

调用 GetExecution 接口指定 RunId 获取媒体处理任务执行结果。

注意事项

  • 该接口仅支持白名单用户调用。使用前请提交工单联系火山引擎技术支持团队申请开通。
  • 本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求说明

  • 请求方式：GET
  • 请求地址：https://vod.volcengineapi.com?Action=GetExecution&Version=2023-07-01

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

Query

参数
类型
是否必选
示例值
描述
Action
String
是
GetExecution
接口名称。当前 API 的名称为 GetExecution。
Version
String
是
2023-07-01
接口版本。当前 API 的版本为 2023-07-01。
RunId
String
是
hb:ebd05bee1f3873***f7316c742b5f
执行 ID。用于唯一指示当前这次媒体处理任务。可通过 StartExecution 接口的返回参数获取。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数
类型
示例值
描述
RunId
String
c5cacd4946bd880a5fd9f74159b03ae8
执行 ID。
Status
String
Success

任务状态。取值如下：

  • Success：任务成功

  • Failed：任务失败

  • PendingStart：任务排队中

  • Running：任务执行中

  • Terminated：任务被终止

Meta
Object
-
任务元信息。
SpaceName
String
docspace
点播空间名称。
Trigger
String
API

任务来源。取值如下：

  • API：调用接口触发
  • AutoTrigger：上传自动触发
  • TranscodeStrategy：转码策略触发
CreateTime
String
2025-01-23T10:05:54Z
任务创建时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。
StartTime
String
2025-01-23T10:05:55Z
任务开始时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。
EndTime
String
2025-01-23T10:08:17Z
任务结束时间。遵循 RFC3339 格式的东八区（UTC+8）时间，精度为秒。
Control
Object
-
任务控制配置。
ClientToken
String
1234567891012345678901234
用户请求凭证，用于区分不同请求。仅当您在提交媒体处理任务时设置了 ClientToken 参数时返回。
CallbackArgs
String
Example
您在提交媒体处理任务时设置的自定义信息。仅当您在提交媒体处理任务时设置了 CallbackArgs 参数时返回。
Input
Object
-
任务输入文件信息。
Type
String
Vid

输入文件类型。取值如下：

  • Vid：Vid 模式。
  • DirectUrl：DirectUrl 模式。
Vid
String
v0325cg10001cu917jaljht7ks0d60i0
视频 ID。仅当 Type 取值为 Vid 时，返回该参数。
DirectUrl
Object
-
DirectUrl 模式下的文件信息。仅当 Type 取值为 DirectUrl 时，返回该参数。
SpaceName
String
test
点播空间名称。
FileName
String
example.mp4
文件路径。
BucketName
String
tos-cn-v-cd3a11
空间所绑定的存储桶名称。
FileId
Object
-
文件 ID 信息。
Vid
String
v0d25cg10001cu7jcvqljht8dj05mde0
视频 ID。
FileId
String
92bf32f3b6364bc1aed416c0c712c9ec
文件 ID
Operation
Object
-
媒体处理操作配置。
Type
String
Task
处理类型。当前仅支持 Task（单任务）。
Task
Object
-
单任务配置。当 Type 为 Task 时返回该参数。
Type
String
Highlight

任务类型：

  • Highlight: 高光分析任务。
  • AdAudit: 巨量广告预审任务。
  • AudioExtract: 音频提取任务。
  • Vision: 大模型视频理解任务。
  • Asr: 语音转写任务。
Highlight
Object
-
高光分析任务配置。
Vision
Object
-
视频理解任务配置。
Prompt
String
请根据输入的视频抽帧图片信息以及音频转译文本，撰写视频内容梗概。要求涵盖视频主要情节、关键人物以及核心事件，语言简洁流畅，逻辑清晰。
大模型提示词。
Model
Object
-
大模型配置。
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: 并发版
AdAudit
Object
-
巨量广告预审任务配置。
AdvertiserId
String
18124962***00731
广告主 ID。
BusinessType
String
ad

广告投放渠道：

AudioExtract
Object
-
音频提取任务配置。
Voice
Boolean
true
是否提取人声。
Asr
Object
-
语音转写任务配置。
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 返回置信度。
Output
Object
-
任务输出文件信息。
Type
String
Task
任务类型。当前仅支持 Task（单任务输出结果）。
Task
Object
-
单任务输出结果。
Type
String
Highlight

任务类型：

  • Highlight: 高光分析任务。
  • AdAudit: 巨量广告预审任务。
  • AudioExtract: 音频提取任务。
  • Vision: 大模型视频理解任务。
  • Asr: 语音转写任务。
Highlight
Object
-
高光分析任务输出结果。
Duration
Float
75.093333
输入视频总时长，单位为秒。
Clips
Object[]
-
高光片段信息。
Start
Float
0.52
高光片段开始时间，单位为秒。
End
Float
3.52
高光片段结束时间，单位为秒。
Vision
Object
-
大模型视频理解任务输出结果。
Duration
Float
70.1
视频时长，单位为秒。
Model
Object
-
大模型视频任务输出结果。
DoubaoInputTokens
Integer
2564
豆包输入令牌数量。
DoubaoOutputTokens
Integer
528
豆包输出令牌数量。
DoubaoTotalTokens
Integer
3092
豆包总计令牌数量。
Content
String
视频展示的是xxx。以下是视频的具体内容xxx
视频理解结果。
SnapshotsNumber
Integer
50
截图张数。
Prompt
String
请根据输入的视频抽帧图片信息以及音频转译文本，撰写视频内容梗概。要求涵盖视频主要情节、关键人物以及核心事件，语言简洁流畅，逻辑清晰。 \n\n# 限制\n 输出的长度不要超过2000字
大模型提示词。
AudioExtract
Object
-
音频提取任务输出结果。
Duration
Float
152.085
视频时长，单位为秒。
Voice
Object
-
人声文件信息。
Size
String
2519064
文件大小，单位为字节。
FileName
String
9c78b9bbb841***586252231dadc9422_speech.aac
文件路径。
Background
Object
-
剥离人声后的背景声文件信息。
Size
String
2519064
文件大小，单位为字节。
FileName
String
9c78b9bbb841***586252231dadc9422_speech.aac
文件路径。
AdAudit
Object
-
巨量广告预审任务输出结果。
Status
String
AuditResult__PASS

审核状态：

  • AuditResult__PASS: 审核通过
  • AuditResult__REJECT: 审核不通过
Reason
String
您好，素材中不得涉及虚假宣传或误导用户的内容xxx
审核建议。
Code
String
1000127
拒绝码。内部参数，暂不生效。
Label
String
["10139"]
审核流控标。内部参数，暂不生效。
Duration
Float
152.085
视频时长，单位为秒。
Asr
Object
-
语音转写任务输出结果。
Duration
Float
70.1
视频时长，单位为秒。
Confidence
Float
0.948533624991474
置信度。
Utterances
Object[]
-
声音信息。
Attribute
Object
-
声音属性。
Confidence
String
0.914009673595429
置信度。
Event
String
speech

识别类型，取值如下：

  • speech: 对话
  • singing: 歌唱
Speaker
String
1
识别的说话人。
Start
Float
13.88
开始时间，单位为秒。
End
Float
15.88
结束时间，单位为秒。
Text
String
火山引擎视频云
识别的文本信息。

请求示例

GET https://vod.volcengineapi.com?Action=GetExecution&Version=2023-07-01&RunId=hb:ebd05bee1f3873***f7316c742b5f

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250123190440C4A3C033C2565A2FD334",
    "Action": "GetExecution",
    "Version": "2023-07-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "RunId": "c5cacd4946bd880a5fd9f74159b03ae8",
    "Status": "Success",
    "Meta": {
      "SpaceName": "docspace",
      "Trigger": "API",
      "CreateTime": "2025-01-23T10:05:54Z",
      "StartTime": "2025-01-23T10:05:55Z",
      "EndTime": "2025-01-23T10:08:17Z"
    },
    "Control": {
      "ClientToken": "1234567891012345678901234"
    },
    "Input": {
      "Type": "Vid",
      "Vid": "v0325cg10001cu917jaljht7ks0d60i0"
    },
    "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
            }
          ]
        }
      }
    }
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。