logologo
售前咨询
点播云
文档中心
服务端API媒体处理查询媒体处理作业

查询媒体处理作业


查询媒体处理作业

请求参数

字段

类型

是否必填

示例

描述

Action

String

DescribeMediaProcessJob

公共参数,本接口取值:DescribeMediaProcessJob

ProcessType

String

MediaFeatureAnalysis

媒体处理的作业类型:

  1. MediaFeatureAnalysis

默认:MediaFeatureAnalysis

JobId

String

40d309d3b2bf373cd3f08e5b5e1bddf720160816

作业ID

SpaceName

String

test

子空间名称

默认:default_space


返回参数

参数名称

类型

示例

描述

CreateTime

String

2021-11-09T12:00:00Z

任务创建的时间,日期格式按照ISO8601标准表示,使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。

例如,2021-11-09T12:00:00Z代表北京时间2021年11月29日的20点0分0秒。


ProcessTime

String

2021-11-09T12:00:00Z

任务开始执行的时间,日期格式按照ISO8601标准表示,使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。

例如,2021-11-09T12:00:00Z代表北京时间2021年11月29日的20点0分0秒。


FinishTime

String

2021-11-09T12:00:00Z

任务结束的时间,日期格式按照ISO8601标准表示,使用UTC时间,格式为:YYYY-MM-DDThh:mm:ssZ。

例如,2021-11-09T12:00:00Z代表北京时间2021年11月29日的20点0分0秒。


ProcessType

String


任务类型

Status

String

processing

任务状态。可选值:

pending:排队中、

processing: 处理中、

completed: 执行成功、

error: 执行失败

JobInfo

JobInfo


任务详细信息

JobInfo

参数名称

类型

示例

描述

JobId

String

40d309d3b2bf373cd3f08e5b5e1bddf720160816

作业ID

TemplateId

String

12rqdaFar2

模板ID

UrlPaths

String

sfas/adf.mp4

转出文件的url或者目录,多个逗号分割

MediaInfos

Array of MediaInfo


视频流信息

MediaFeature

MediaFeature


媒体特征信息

ErrorCode

String


失败时的错误码,0是完成,其他是失败,是否转出成功的信息需要关注MediaInfo中的ErrorCode

ErrorMessage

String


失败时的错误信息


MediaFeature

参数名称

变量类型

示例

参数描述

QualityFeature

QualityFeature


画质特征

AestheticsFeature

AestheticsFeature


美学特征

ContentFeature

ContentFeature


内容特征

AudioFeature

AudioFeature


音频特征

CodingFeature

CodingFeature


编码特征

SceneFeature

SceneFeature


场景特征

Version

String

premium

KVQ任务版本

QualityFeature

参数名称

变量类型

示例

参数描述

NrQualityAvgScore

Float

1

无参考质量评价分数,取值区间:[1-5]

BlurProbability

Float

1

模糊程度,取值区间:[0-1]

BlockyProbability

Float

1

块效应程度,取值区间:[0-1]

NoiseProbability

Float

1

噪声程度,取值区间:[0-1]

sharpness

Float

1

锐化程度,取值区间:[0-1]

InterlaceRatio

Float

1

交错视频概率,取值区间:[0-1]

DirtylensProbability

Float

1

镜头脏污程度,取值区间:[0-1]

BlurProbabilityNew

Float

1

新版本模型的模糊概率,越高表示越模糊,取值区间:[0-1]

BlockyProbabilityNew

Float

1

新版本模型的有块效应的概率,越高表示块效应程度越大,取值区间:[0-1]

LowLightPercentage

Float

1

暗光的概率,越高表示越可能是暗光情况,取值区间:[0-1]。视频专属的特征值。

CorruptionProbability

Float

1

花屏的概率,越高表示越可能是花屏,取值区间:[0-1]

NoiseProbabilityNew

Float

1

新版本模型的噪声概率,越高表示越可能有噪声,取值区间:[0-1]

InterlaceScaleClass

Float

1

interlace比例,取值区间:[0-1]

NrQualityScoreNN

Array of Float


无参考质量评价分数体系,取值区间:[1-5]

AestheticsFeature

参数名称

变量类型

示例

参数描述

DefocusProbability

Double

1

大光圈概率,取值区间:[0-1]

Colorfulness

Double

1

颜色丰富度,取值区间:[0-1]

UnderexposedProbability

Double

1

曝光不足程度,取值区间:[0-1]

OverexposedProbability

Double

1

曝光过度程度,取值区间:[0-1]

LowContrastProbability

Double

1

低对比度程度,取值区间:[0-1]

AestheticsScore

Double

1

美学,取值区间:[0-1]

ContentFeature

参数名称

变量类型

示例

参数描述

JunkVideoProbability

Float

1

内容无意义,取值区间:[0-1]

LetterboxProbability

Float

1

三段式视频,取值区间:[0-1]

OritationProbability

Float

1

横屏视频概率,取值区间:[0-1]

R0Probability

Float


横屏的概率

R90Probability

Float


旋转90度的概率,越大概率越高

R270Probability

Float


旋转270度的概率,越大概率越高

NormalProbability

Float


普通画面概率,取值区间:[0-1]

PureProbability

Float


纯色画面概率,取值区间:[0-1]

TextProbability

Float


文字画面概率,取值区间:[0-1]

CartoonProbability

Float


卡通画面概率,取值区间:[0-1]

QrcodeProbability

Float


二维码画面概率,取值区间:[0-1]

LetterboxTop

Array of Float


画面上边占比,取值区间:[0-1]

LetterboxBottom

Array of Float


画面下边占比,取值区间:[0-1]

FaceRatio

Float


视频中含有人脸的视频帧占比,取值区间:[0-1]

VrVideo

int


1表示为vr视频,0表示不是

AudioFeature

参数名称

变量类型

示例

参数描述

AudioQuality

Double

1

音频质量,取值区间:[0-1]

MusicProbability

Double

1

音频为音乐概率,取值区间:[0-1]

DialogProbability

Double

1

音频为对话概率,取值区间:[0-1]

BackgroundSoundProbability

Double

1

音频为背景声概率,取值区间:[0-1]

MutePercentage

Double

1

无声占比,取值区间:[0-1]


CodingFeature

参数名称

变量类型

示例

参数描述

EntropyAvg

Float

1

帧内复杂度的均值,越大表示图像/视频帧复杂度越高,取值范围大致在-6到26。

EntropyVar

Float

100

帧内复杂度的方差,越大表示视频内复杂度变化范围越大,取值 : >0。

IntraComplexity

Float

1

帧内复杂度,取值范围:>0

InterComplexity

Float

1

帧间复杂度,取值范围:>0

TopIntraComplexity

Float

1

多帧帧内复杂度TOP部分,取值范围:>0

TopInterComplexity

Float

1

多帧帧间复杂度TOP部分,取值范围:>0

MaxIntraComplexity

Float

1

多帧帧内复杂度最大值,取值范围:>0

MaxInterComplexity

Float

1

多帧帧间复杂度最大值,取值范围:>0

MinIntraComplexity

Float

1

多帧帧内复杂度最小值,取值范围:>0

MinInterComplexity

Float

1

多帧帧间复杂度最小值,取值范围:>=0

YMean

Float

1

Y通道均值,取值范围:>0,视频专属的特征值。

YMeanMax

Float

1

多帧Y通道均值最大值,取值范围:>0,视频专属的特征值。

YMeanMin

Float

1

多帧Y通道均值最小值,取值范围:>=0,视频专属的特征值。

YDiffStd

Float

1

Y通道差异标准差,取值范围:>0,视频专属的特征值。

YDiffStdMax

Float

1

多帧Y通道差异标准差最大值,取值范围:>0,视频专属的特征值。

YDiffStdMin

Float

1

多帧Y通道差异标准差最小值,取值范围:>=0,视频专属的特征值。

CapeMotionVertical

Float

1

垂直运动量,取值范围:>0

CapeMotionHorizon

Float

1

水平运动量,取值范围:>0

Embedding

Array of Float

无范围限制

编码特征向量

SceneFeature

参数名称

变量类型

示例

参数描述

OthersProbability

Float

1

场景-其他类别概率,取值区间:[0-1]

SkyProbability

Float

1

场景-天空画面概率,取值区间:[0-1]

MountainProbability

Float

1

场景-高山画面概率,取值区间:[0-1]

FieldProbability

Float

1

场景-田野画面概率,取值区间:[0-1]

WoodProbability

Float

1

场景-树木画面概率,取值区间:[0-1]

WaterProbability

Float

1

场景-水画面概率,取值区间:[0-1]

CrowdProbability

Float

1

场景-人群画面概率,取值区间:[0-1]

PersonProbability

Float

1

场景-全身人像概率,取值区间:[0-1]

PortraitProbability

Float

1

场景-半身人像概率,取值区间:[0-1]

CarProbability

Float

1

场景-汽车概率,取值区间:[0-1]

WriteProbability

Float

1

场景-文本概率,取值区间:[0-1]

FoodProbability

Float

1

场景-美食画面概率,取值区间:[0-1]

CgProbability

Float

1

场景-cg画面概率,取值区间:[0-1]

NightProbability

Float

1

场景-夜景画面概率,取值区间:[0-1]

PurecolorProbability

Float

1

场景-纯色图片概率,取值区间:[0-1]

CapProbability

Float

1

场景-字幕概率,取值区间:[0-1]

MobaProbability

Float

1

场景-王者荣耀概率,取值区间:[0-1]

FpsProbability

Float

1

场景-吃鸡游戏概率,取值区间:[0-1]

StageProbability

Float

1

舞台类别概率,取值区间:[0-1]

MediaInfo

参数名称

变量类型

示例

参数描述

UrlPath

String

sfas/adf.mp4

转出文件的url

VideoStreams

Array of VideoStreamInfo


视频流信息

AudioStreams

Array of AudioStreamInfo


音频流信息

Format

Format


封装格式等信息

ErrorCode

String


失败时的错误码,0是成功,其他是失败

ErrorMessage

String


失败时的错误信息

VideoStreamInfo

参数名称

变量类型

示例

参数描述

CodeType

String

video

文件类型

CodecName

String

hevc

编码器名称

Width

Integer

1080

Height

Integer

1920

AvgFrameRate

String

24135680/804527

平均帧率

RFrameRate

String

30/1

帧率

Bitrate

Long

12800

码率

StartTime

Double

0

开始时间

PixFmt

String

yuv420p

PixelFormat像素格式

HdrType

String

SDR

hdr类型

Duration

Double

314.268359

时长,单位:秒

AudioStreamInfo

参数名称

变量类型

示例

参数描述

CodeType

String

audio

文件类型

StartTime

Double

0

开始时间

Duration

Double

314.268359

时长,单位:秒

CodecName

String

aac

编码器名称

Channels

Integer

1

声道数

SampleRate

Long

48000

采样率

Bitrate

Long

12800

码率

Format

参数名称

变量类型

示例

参数描述

FormatName

String

MP4

文件封装格式

ListSize

Long

1111

m3u8文件的大小,单位: byte

Size

Long

34175849

文件大小, 单位: byte

Duration

Double

314.304

总时长,单位:s

Bitrate

Long

869880

码率


API示例

请求示例

curl -X POST 'https://vod.streamlakeapi.com/?Action=DescribeMediaProcessJob' \
-H 'Content-Type: application/json' \
-H <公共请求参数>

请求参数示例值

Content-Type: application/json
{
"JobId" : "4bad1b9e-8d87-4917-a72a-79d3fefc007a-20240108-0"
}


返回示例

HTTP/1.1 200 OK
Content-Type: application/json
{
"ResponseMeta": {
"RequestId": "ELeAgICw5rSLChhgILXFhd7PMSias_-QAw==",
"ErrorCode": "",
"ErrorMessage": ""
},
"ResponseData": {
"ProcessType": "MediaFeatureAnalysis",
"Status": "completed",
"ProcessTime": "2024-01-08T08:19:57Z",
"FinishTime": "2024-01-08T08:20:16Z",
"JobInfo": {
"JobId": "4bad1b9e-8d87-4917-a72a-79d3fefc007a-20240108-0",
"TemplateId": "",
"UrlPaths": "",
"ErrorCode": "0",
"ErrorMessage": "",
"MediaInfos": [
{
"VideoStreams": [
{
"CodecType": "video",
"CodecName": "h264",
"Width": 1440,
"Height": 3118,
"AvgFrameRate": "30/1",
"Bitrate": 21898833,
"StartTime": 0.0,
"PixFmt": "yuv420p",
"HdrType": "SDR",
"Duration": 44.6,
"RFrameRate": "30/1"
}
],
"AudioStreams": [
{
"CodecType": "audio",
"StartTime": 0.0,
"Duration": 44.605011,
"CodecName": "aac",
"Channels": 2,
"SampleRate": 44100,
"Bitrate": 193084
}
],
"Format": {
"FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
"Size": 123185115,
"Duration": 44.606
}
}
],
"MediaFeature": {
"Version" : "premium",
"QualityFeature": {
"NrQualityAvgScore": 3.6722004413604736,
"BlurProbability": 0.2845825254917145,
"BlockyProbability": 0.35206449031829834,
"NoiseProbability": 0.167724609375,
"InterlaceRatio": 0.0,
"DirtylensProbability": 0.035475920885801315
},
"AestheticsFeature": {
"DefocusProbability": 0.1572059690952301,
"Colorfulness": 0.43736614590868184,
"UnderexposedProbability": 1.4901161193847656E-8,
"OverexposedProbability": 1.370906801412275E-7,
"LowContrastProbability": 1.1208355135750026E-4,
"AestheticsScore": 0.5756559371948242
},
"ContentFeature": {
"JunkVideoProbability": 0.0,
"LetterboxProbability": 0.9995697736740112,
"OritationProbability": 0.0
},
"AudioFeature": {
"AudioQuality": 0.9473018646240234,
"MusicProbability": 0.45265185832977295,
"DialogProbability": 0.4843069016933441,
"BackgroundSoundProbability": 0.0630413070321083,
"MutePercentage": 0.0
}
}
},
"CreateTime": "2024-01-08T08:19:08Z"
}
}


错误码

ErrorCode

ErrorMessage

说明

状态码

InvalidArgument

MediaProcessJob is not found

没有找到这个媒体处理任务

404

InvalidArgument

JobId is null

JobId为空

400

InvalidArgument

ProcessType invalid, should be MediaFeatureAnalysis

ProcessType 无效,应该是MediaFeatureAnalysis

400

上一篇:查询任务流状态下一篇:获取媒体处理作业结果列表
该篇文档内容是否对您有帮助?
有帮助没帮助