查询单个转码任务详情。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用前面加 * 表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ice:GetTranscodeJob | *全部资源 * |
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ParentJobId | string | 是 | 任务 ID | ab4802364a2e49208c99efab82dfa8e8 |
返回参数
名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
object | 返回结果。 | ||
RequestId | string | 请求 ID。 | 9EDC30DC-0050-5459-B788-F761B2BE359B |
TranscodeParentJob | object | TranscodeParentJobWithSubJobDTO | |
TranscodeJobList | array<object> | 子任务列表。 | |
TranscodeJobList | object | 子任务。 | |
CreateTime | string | 任务创建时间。 | 2022-01-12T08:49:41Z |
Name | string | 任务名。 | transcode-job |
ParentJobId | string | 主任务 ID。 | 8b2198504dd340b7b3c9842a74fc9baa |
JobId | string | 子任务 ID。 | 7d6a7e0d4db2457a8d45ff5d43e1bf0a |
JobIndex | integer | 子任务在整个任务中的索引号。 | 0 |
InputGroup | array<object> | 任务输入组。单个输入为转码任务。多个输入为音视频合流任务。 | |
InputGroup | object | 作业输入。 | |
Type | string | 媒体对象类型。 取值:
| OSS |
Media | string | 媒体值:
| oss://bucket/path/to/video.mp4 |
InputUrl | string | 媒资流地址,只有当对媒资流进行转码时填写此参数。 | oss://bucket/path/to/video.mp4 |
ProcessConfig | object | 转码处理配置。 | |
Transcode | object | 转码配置。 | |
TemplateId | string | 模板 ID。 | 9547c6ad97cb4f2aaa29683ebd18d410 |
OverwriteParams | object | 覆盖参数, 若填写会覆盖模板对应参数。 | |
Video | object | video 设置。 | |
Codec | string | 编码格式。 | H.264 |
Profile | string | 编码级别。 支持 baseline、main、high。
默认值:high。 | Main |
Bitrate | string | 视频平均码率。
| 3000 |
Crf | string | 码率-质量控制因子。
如果设置了 Crf,则 Bitrate 的设置失效。 | 23 |
Width | string | 宽。
默认值:视频原始宽度。 | 1920 |
Height | string | 高。
默认值:视频原始高度。 | 1080 |
Fps | string | 帧率。
| 25 |
Gop | string | 关键帧间最大帧数。
| 250 |
Preset | string | 视频算法器预置。只有 H264 支持该参数。 支持 veryfast、fast、medium、slow、slower。 默认值:medium。 | medium |
ScanMode | string | 扫描模式。 支持 interlaced、progressive。 | progressive |
PixFmt | string | 视频颜色格式。 范围:yuv420p,yuvj420p 等标准颜色格式。 | yuv420p |
Remove | string | 是否去掉视频。 | false |
Crop | string | 视频画面裁切,支持 2 种方式:
| 1280:800:0:140 |
Pad | string | 视频贴黑边,参数格式:width:height:left:top。 | 1280:800:0:140 |
LongShortMode | string | 是否开启横竖屏自适应(即:长短边模式)。 | false |
Bufsize | string | 缓冲区大小:
| 6000 |
Maxrate | string | 视频码率峰值:
| 9000 |
AbrMax | string | abr 最大码率(只有窄高 1 有效):
| 6000 |
Audio | object | audio 设置。 | |
Codec | string | 音频编解码格式,AAC、MP3、VORBIS、FLAC。 默认值:AAC | AAC |
Profile | string | 音频编码预置。 当 Codec 为 AAC 时,范围 aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。 | aac_low |
Samplerate | string | 采样率。
| 44100 |
Bitrate | string | 输出文件的音频码率。
| 128 |
Channels | string | 声道数。 默认值:2 | 2 |
Remove | string | 是否删除音频流。 | false |
Volume | object | 音量控制。 | |
Method | string | 音量调整方式。 | auto |
IntegratedLoudnessTarget | string | 目标音量。 | -6 |
TruePeak | string | 最大峰值。 | -1 |
LoudnessRangeTarget | string | 音量范围。 | 8 |
Container | object | 封装格式设置。 | |
Format | string | 容器格式。 | mp4 |
MuxConfig | object | 封装设置。 | |
Segment | object | 切片设置。 | |
Duration | string | 切片时长。 | 10 |
ForceSegTime | string | 强制切片时间点。 | 2,3 |
TransConfig | object | 条件转码参数。 | |
TransMode | string | 视频转码模式。取值如下:
默认值:onepass。 | onepass |
IsCheckReso | string | 是否检查视频分辨率。IsCheckReso 和 IsCheckResoFail 只支持二选一,IsCheckResoFail 优先级更高。
默认值:false。 | true |
IsCheckResoFail | string | 是否检查视频分辨率。IsCheckReso 和 IsCheckResoFail 只支持二选一,本参数优先级更高。
默认值:false。 | true |
IsCheckVideoBitrate | string | 是否检查视频码率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支持二选一,IsCheckVideoBitrateFail 优先级更高。
默认值:false。 | true |
IsCheckVideoBitrateFail | string | 是否检查视频码率。IsCheckVideoBitrate 和 IsCheckVideoBitrateFail 只支持二选一,本参数优先级更高。
默认值:false。 | true |
IsCheckAudioBitrate | string | 是否检查音频码率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支持二选一,IsCheckAudioBitrateFail 优先级更高。
默认值:
| true |
IsCheckAudioBitrateFail | string | 是否检查音频码率。IsCheckAudioBitrate 和 IsCheckAudioBitrateFail 只支持二选一,本参数优先级更高。
默认值:false。 | true |
AdjDarMethod | string | 分辨率改写方式。当 Width 或 Height 都填写时才生效,可以和 LongShortMode 搭配使用。 可选值:rescale、crop、pad、none。 默认值:none。 示例:请参见如何设置分辨率。 | none |
ImageWatermarks | array<object> | 图片水印配置。 | |
ImageWatermark | object | 图片水印配置。 | |
TemplateId | string | 模板 ID。 | 9547c6ad97cb4f2aaa29683ebd18d410 |
OverwriteParams | object | 覆盖参数, 若填写会覆盖模板对应参数。 | |
Width | string | 宽。 | 32 |
Height | string | 高。 | 32 |
Dx | string | 水印位置,x。 | 10 |
Dy | string | 水印位置,y。 | 10 |
ReferPos | string | 参考位置:TopLeft, TopRight, BottomLeft, BottomRight | TopLeft |
Timeline | object | 显示时间设置。 | |
Start | string | 开始时间。 | 00:00:05 |
Duration | string | 显示时长,秒数或者 "ToEND"。 | ToEND |
File | object | 水印图片文件。 | |
Type | string | 媒体对象类型。 取值:
| OSS |
Media | string | 媒体值:
| oss://bucket/path/to/video.mp4 |
TextWatermarks | array<object> | 文字水印配置。 | |
TextWatermark | object | 文字水印配置。 | |
TemplateId | string | 模板 ID。 | 9547c6ad97cb4f2aaa29683ebd18d410 |
OverwriteParams | object | 覆盖参数, 若填写会覆盖模板对应参数。 | |
Content | string | 水印文本,不需要 base64 encode,字符串需要 utf-8 编码。 | 测试水印 |
FontName | string | 字体。 | SimSun |
FontColor | string | 颜色。 | #006400 |
FontAlpha | string | 透明度。 | 1.0 |
Top | string |