GetVideoAnalysisTask - 视频理解-获取异步任务状态和结果

轻应用-获取视频理解异步任务结果。

接口说明

阿里云百炼轻应用-视频理解-获取异步任务状态和结果:通过这个接口可以查看“提交异步任务”接口提交的视频理解任务状态和结果。欢迎前往视频理解控制台体验。

说明 当返回结果中包含header -> errorCode = ViolationOfSecurityPolicy时,表明该请求触发了系统的安全策略限制,请对请求内容进行相应的修改。此时,videoAnalysisResult等业务数据返回为空。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
quanmiaolightapp:GetVideoAnalysisTaskget
*全部资源
*

请求语法

GET /{workspaceId}/quanmiao/lightapp/videoAnalysis/getVideoAnalysisTask HTTP/1.1

请求参数

名称类型必填描述示例值
workspaceIdstring

阿里云百炼业务空间唯一标识:获取 workspaceId

llm-xxxx
taskIdstring

任务唯一标识

a3d1c2ac-f086-4a21-9069-f5631542f5a2

返回参数

名称类型描述示例值
object

Schema of Response

requestIdstring

Id of the request

5D0E915E-655D-59A8-894F-93873F73AAE5
codestring

状态码

successful
messagestring

错误说明

success
httpStatusCodeinteger

http 状态码

200
successboolean

是否成功:true 成功,false 失败

True
dataobject

结果

headerobject

event 名称

errorCodestring

异常错误码

success
errorMessagestring

异常错误信息

Deduct task already success,Please do not resubmit.token '369e8f2c-d283-424a-96c4-c83efe08c89e'
eventstring

事件类型

TIMEOUT_CLOSE_ORDER
eventInfostring

事件描述

xxx
sessionIdstring

会话唯一标识

d5c38cf6-a4bf-4a57-a697-9f449926f0c9
taskIdstring

生成唯一标识

6e223291-729b-4e84-9271-c13ada1a776b
traceIdstring

全量路 ID

215045f817272303448235204efdef
payloadobject

结果

outputobject

结果

videoAnalysisResultobject

语言分析对应生成内容

generateFinishedboolean

当前任务是否已生成结束

true
textstring

vl 生成文本结果

xxx
usageobject

Token 数量

inputTokenslong

输入 Token 数量

0
outputTokenslong

输出 Token 数量

0
totalTokenslong

总 Token 数量

0
videoShotAnalysisResultsarray<object>

视频每个分镜对应语言分析结果::因内容较大,请从 resultJsonFileUrl 文件中获取

videoShotAnalysisResultsobject

视频分镜结果

endTimelong

结束时间,相对时间,单位毫秒

10000
startTimelong

开始时间,相对时间,单位毫秒

1000
textstring

生成原始内容

xxxx
videoCaptionResultobject

视频字幕

generateFinishedboolean

当前任务是否已生成结束

true
videoCaptionsarray<object>

视频字幕

videoCaptionsobject

视频字幕

endTimelong

结束时间,相对时间,单位毫秒

20000
endTimeFormatstring

结束时间,格式化结果

00:01
startTimelong

开始时间,相对时间,单位毫秒

1000
startTimeFormatstring

开始时间,格式化结果

00:01
textstring

字幕内容

xxxx
speakerstring

角色

张三
videoGenerateResultobject

文本总结结果:多任务时,请从 videoGenerateResults 字段获取结果

generateFinishedboolean

当前任务是否已生成结束

true
textstring

生成文本

xxx
usageobject

输出 Token 数量

inputTokenslong

输入 Token 数量

1
outputTokenslong

输出 Token 数量

1
totalTokenslong

总 Token 数量

2
modelIdstring

模型 id

qwen-max-latest
modelReduceboolean

模型是否被降级:如果模型是 qwen-max 或 qwen-max-latest,且超过 prompt 输入上限时,会尝试降级到 qwen-plus-latest 模型,保证信息完整性

qwen-plus-latest
reasonTextstring

模型思考过程

xx
indexinteger

多任务标号:1 开始

1
videoMindMappingGenerateResultobject

脑图生成结束

generateFinishedboolean

当前任务是否已生成结束

true
textstring

生成文本

小吃街
usageobject

输入 Token 数量

inputTokenslong

输入 Token 数量

1
outputTokenslong

输出 Token 数量

1
totalTokenslong

总 Token 数量

2
videoMindMappingsarray<object>

脑图结果

videoMindMappingsobject

子节点

childNodesarray<object>

子节点

childNodesobject

子节点

childNodesarray<object>

子节点

childNodesobject

节点描述

namestring

节点描述

三级节点
namestring

节点描述

二级节点
namestring

节点描述

三级节点
videoTitleGenerateResultobject

标题生成结果

generateFinishedboolean

当前任务是否已生成结束

true
textstring

文本生成结果

xxxx
usageobject

Token 数量

inputTokenslong

输入 Token 数量

0
outputTokenslong

输出 Token 数量

0
totalTokenslong

总 Token 数量

0
resultJsonFileUrlstring

结果 json 文件地址:

由于响应结果过大,部分数据获取改为文件方式,可以通过当前字段 url 下载文件,并解析使用:

  • 当前包含的字段:数据结构定义见 RunVideoAnalysis 接口
    • videoShotSnapshotResult:每个分片抽帧信息,包括每帧 url
    • videoShotAnalysisResults:每个分片语言分析结果明细
  • 其他字段获取方式不变,文本方式返回。
  • 文件类型:json
  • 文件内容:全量报文,包含文本方式返回的 返回 event:task-finished
http://xxx
videoGenerateResultsarray<object>

当入参为多任务时(textProcessTasks 有值),返回文本加工结果对应这个字段,可以通过数据所在数组位置(下标)或 index(1 开始)找到对应结果。

llm任务视频总结结果列表object

文本加工任务结果

generateFinishedboolean

当前任务是否已生成结束

true
modelIdstring

模型 id

xx
indexinteger

多任务标号:1 开始

1
textstring

生成内容

xx
reasonTextstring

模型思考过程

xx
usageobject

用量

inputTokenslong

输入 Token 数量

1
outputTokenslong

输出 token 数

1
totalTokenslong

总 token

2
videoRoleRecognitionResultobject

自动识别结果

videoRolesarray<object>

角色列表

角色列表object
roleNamestring

角色名称

xx
roleInfostring

人物信息

xx
timeIntervalsarray<object>

角色出场时间段列表

出场时间段object
startTimelong

开始时间

0
endTimelong

结束时间

342463553646
timestamplong

当前时间段角色出场时间

42553453253
urlstring

角色图片

http://
ratiofloat

出场率

0.2
isAutoRecognitionboolean

自动识别是否使用的是自动识别单独的视频地址(是:则人脸图片无法使用时间与视频帧用时间对应,因为可能是不同的视频)

videoCalculatorResultobject

费用估算结果

itemsarray<object>

计费项明细

计费项明细object

计费项明细

namestring

计费项名称

xxx
typestring

名称

inputTokenlong

类型

outputTokenlong

输入 token

timelong

计费时长

inputExpensedouble

输入 token 计费

outputExpensedouble

输入 token 计费

timeExpensedouble

输出 token 计费

totalExpensedouble

费用

0.098
usageobject

token 描述

inputTokenslong

输入 Token 数量

0
outputTokenslong

输出 Token 数量

0
totalTokenslong

总 Token 数量

0
taskRunInfoobject

运行信息

concurrentChargeEnableboolean

是否使用付费并发:true 时,按照实际运行时长计量

true
responseTimelong

运行时长:从任务被调度开始到任务完成的耗时,单位毫秒

1000
taskStatusstring

任务状态。

  • PENDING:待执行
  • RUNNING:执行中
  • SUCCESSED:成功
  • SUSPENDED:暂停
  • FAILED:失败
  • CANCELED: 取消
SUCCESSED
taskIdstring

任务 ID

3feb69ed02d9b1a17d0f1a942675d300
errorMessagestring

异常错误信息

Access was denied, message: No such namespace namespaces/mjp-test-default.

示例

正常返回示例

JSON格式

{
  "requestId": "5D0E915E-655D-59A8-894F-93873F73AAE5",
  "code": "successful",
  "message": "success",
  "httpStatusCode": 200,
  "success": true,
  "data": {
    "header": {
      "errorCode": "success",
      "errorMessage": "Deduct task already success,Please do not resubmit.token '369e8f2c-d283-424a-96c4-c83efe08c89e'",
      "event": "TIMEOUT_CLOSE_ORDER",
      "eventInfo": "xxx",
      "sessionId": "d5c38cf6-a4bf-4a57-a697-9f449926f0c9",
      "taskId": "6e223291-729b-4e84-9271-c13ada1a776b",
      "traceId": "215045f817272303448235204efdef"
    },
    "payload": {
      "output": {
        "videoAnalysisResult": {
          "generateFinished": true,
          "text": "xxx",
          "usage": {
            "inputTokens": 0,
            "outputTokens": 0,
            "totalTokens": 0,
            "imageTokens": 0
          },
          "videoShotAnalysisResults": [
            {
              "endTime": 10000,
              "startTime": 1000,
              "text": "xxxx"
            }
          ]
        },
        "videoCaptionResult": {
          "generateFinished": true,
          "videoCaptions": [
            {
              "endTime": 20000,
              "endTimeFormat": "00:01",
              "startTime": 1000,
              "startTimeFormat": "00:01",
              "text": "xxxx",
              "speaker": "张三"
            }
          ]
        },
        "videoGenerateResult": {
          "generateFinished": true,
          "text": "xxx",
          "usage": {
            "inputTokens": 1,
            "outputTokens": 1,
            "totalTokens": 2
          },
          "modelId": "qwen-max-latest",
          "modelReduce": true,
          "reasonText": "xx",
          "index": 1
        },
        "videoMindMappingGenerateResult": {
          "generateFinished": true,
          "text": "小吃街",
          "usage": {
            "inputTokens": 1,
            "outputTokens": 1,
            "totalTokens": 2
          },
          "videoMindMappings": [
            {
              "childNodes": [
                {
                  "childNodes": [
                    {
                      "name": "三级节点"
                    }
                  ],
                  "name": "二级节点"
                }
              ],
              "name": "三级节点"
            }
          ]
        },
        "videoTitleGenerateResult": {
          "generateFinished": true,
          "text": "xxxx",
          "usage": {
            "inputTokens": 0,
            "outputTokens": 0,
            "totalTokens": 0
          }
        },
        "resultJsonFileUrl": "http://xxx",
        "videoGenerateResults": [
          {
            "generateFinished": true,
            "modelId": "xx",
            "index": 1,
            "text": "xx",
            "reasonText": "xx",
            "usage": {
              "inputTokens": 1,
              "outputTokens": 1,
              "totalTokens": 2
            }
          }
        ],
        "videoRoleRecognitionResult": {
          "videoRoles": [
            {
              "roleName": "xx",
              "roleInfo": "xx",
              "timeIntervals": [
                {
                  "startTime": 0,
                  "endTime": 342463553646,
                  "timestamp": 42553453253,
                  "url": "http://"
                }
              ],
              "ratio": 0.2,
              "isAutoRecognition": true
            }
          ]
        },
        "videoCalculatorResult": {
          "items": [
            {
              "name": "xxx",
              "type": "",
              "inputToken": 0,
              "outputToken": 0,
              "time": 0,
              "inputExpense": 0,
              "outputExpense": 0,
              "timeExpense": 0,
              "totalExpense": 0.098
            }
          ]
        }
      },
      "usage": {
        "inputTokens": 0,
        "outputTokens": 0,
        "totalTokens": 0
      }
    },
    "taskRunInfo": {
      "concurrentChargeEnable": true,
      "responseTime": 1000
    },
    "taskStatus": "SUCCESSED",
    "taskId": "3feb69ed02d9b1a17d0f1a942675d300",
    "errorMessage": "Access was denied, message: No such namespace namespaces/mjp-test-default."
  }
}

错误码

HTTP status code错误码错误信息描述
403NoPermissionYou are not authorized to perform this action , Please check the assignment of the workspaceId.请检查workspaceId的赋值

访问错误中心查看更多错误码。