华为云用户手册

  • 响应示例 状态码:200 查询转码模板成功。 { "template_array" : [ { "template_id" : 80985, "template" : { "template_name" : "test_template", "video" : { "output_policy" : "transcode", "codec" : 1, "bitrate" : 0, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "bframes_count" : 4, "frame_rate" : 0, "width" : 0, "height" : 0, "black_cut" : 0 }, "audio" : { "output_policy" : "transcode", "codec" : 1, "bitrate" : 0, "sample_rate" : 1, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } } } ], "total" : 1 } 状态码:403 查询转码模板失败。 { "error_code" : "MPC.10212", "error_msg" : "Operation failed." }
  • URI GET /v1/{project_id}/template/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考“获取项目ID”章节。 表2 Query参数 参数 是否必选 参数类型 描述 template_id 否 Array of integers 自定义转码模板ID,最多10个 page 否 Integer 分页编号。查询指定“task_id”时,该参数无效。 默认值:0。 size 否 Integer 每页记录数。取值范围:[1,100],指定template_id时该参数无效
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求示例 更新转码模板。 PUT https://{endpoint}/v1/{project_id}/template/transcodings/ { "template_id" : 1001, "template_name" : "MP4_H.264_1920x1080_6000_HEAAC_PVC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 更新转码模板。 PUT https://{endpoint}/v1/{project_id}/template/transcodings/ { "template_id" : 1001, "template_name" : "MP4_H.264_1920x1080_6000_HEAAC_PVC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 更新转码模板。 PUT https://{endpoint}/v1/{project_id}/template/transcodings/ { "template_id" : 1001, "template_name" : "MP4_H.264_1920x1080_6000_HEAAC_PVC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 更新转码模板。 PUT https://{endpoint}/v1/{project_id}/template/transcodings/ { "template_id" : 1001, "template_name" : "MP4_H.264_1920x1080_6000_HEAAC_PVC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求示例 新建转码模板,采用自定义的模板转码。 POST https://{endpoint}/v1/{project_id}/template/transcodings { "template_name" : "MP4_H.264_1920x1080_6000_HEAAC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 新建转码模板,采用自定义的模板转码。 POST https://{endpoint}/v1/{project_id}/template/transcodings { "template_name" : "MP4_H.264_1920x1080_6000_HEAAC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 新建转码模板,采用自定义的模板转码。 POST https://{endpoint}/v1/{project_id}/template/transcodings { "template_name" : "MP4_H.264_1920x1080_6000_HEAAC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • 请求示例 新建转码模板,采用自定义的模板转码。 POST https://{endpoint}/v1/{project_id}/template/transcodings { "template_name" : "MP4_H.264_1920x1080_6000_HEAAC", "video" : { "codec" : 1, "bitrate" : 6000, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "black_cut" : 0, "bframes_count" : 4, "frame_rate" : 1, "width" : 1920, "height" : 1080 }, "audio" : { "codec" : 1, "sample_rate" : 4, "bitrate" : 128, "channels" : 2 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } }
  • URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of longs 转码服务接受任务后产生的任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下: WAITING:等待启动 TRANSCODING:转码中 SUCCEEDED:转码成功 FAILED:转码失败 CANCELED:已删除 NEED_TO_BE_AUDIT:片源待审核 start_time 否 String 起始时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 end_time 否 String 结束时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 page 否 Integer 分页编号。查询指定“task_id”时,该参数无效。 默认值:0。 size 否 Integer 每页记录数。查询指定“task_id”时,该参数无效。 取值范围:[1,100]。 默认值:10。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 x-language 否 String 客户端语言 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 响应示例 状态码:200 查询转码任务成功。 { "is_truncated" : 0, "total" : 1, "task_array" : [ { "task_id" : 22123973, "status" : "SUCCEEDED", "create_time" : 20200310031605, "end_time" : 20200310031623, "trans_template_id" : [ 4 ], "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-output.mp4" }, "output_file_name" : [ "example_480X270.m3u8" ], "transcode_detail" : { "multitask_info" : [ { "template_id" : 4, "output_file" : { "duration" : 59, "duration_ms" : 0, "format" : "HLS", "size" : 2180, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 231, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "H264" }, "audio_info" : [ { "codec" : "HEAAC", "sample" : 44100, "channels" : 2, "bitrate" : 64, "bitrate_bps" : 0 } ] } } ], "input_file" : { "duration" : 59, "duration_ms" : 0, "format" : "MOV", "size" : 2494653, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 199, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "HEVC" }, "audio_info" : [ { "codec" : "AAC", "sample" : 48000, "channels" : 2, "bitrate" : 128, "bitrate_bps" : 0 } ] } } } ] } 状态码:400 查询转码任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter" }
  • 响应示例 状态码:200 查询转码任务成功。 { "is_truncated" : 0, "total" : 1, "task_array" : [ { "task_id" : 22123973, "status" : "SUCCEEDED", "create_time" : 20200310031605, "end_time" : 20200310031623, "trans_template_id" : [ 4 ], "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-output.mp4" }, "output_file_name" : [ "example_480X270.m3u8" ], "transcode_detail" : { "multitask_info" : [ { "template_id" : 4, "output_file" : { "duration" : 59, "duration_ms" : 0, "format" : "HLS", "size" : 2180, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 231, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "H264" }, "audio_info" : [ { "codec" : "HEAAC", "sample" : 44100, "channels" : 2, "bitrate" : 64, "bitrate_bps" : 0 } ] } } ], "input_file" : { "duration" : 59, "duration_ms" : 0, "format" : "MOV", "size" : 2494653, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 199, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "HEVC" }, "audio_info" : [ { "codec" : "AAC", "sample" : 48000, "channels" : 2, "bitrate" : 128, "bitrate_bps" : 0 } ] } } } ] } 状态码:400 查询转码任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter" }
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 x-language 否 String 客户端语言 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考“获取项目ID”章节。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of longs 转码服务接受任务后产生的任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下: WAITING:等待启动 TRANSCODING:转码中 SUCCEEDED:转码成功 FAILED:转码失败 CANCELED:已删除 NEED_TO_BE_AUDIT:片源待审核 start_time 否 String 起始时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 end_time 否 String 结束时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 page 否 Integer 分页编号。查询指定“task_id”时,该参数无效。 默认值:0。 size 否 Integer 每页记录数。查询指定“task_id”时,该参数无效。 取值范围:[1,100]。 默认值:10。
  • URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考“获取项目ID”章节。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of longs 转码服务接受任务后产生的任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下: WAITING:等待启动 TRANSCODING:转码中 SUCCEEDED:转码成功 FAILED:转码失败 CANCELED:已删除 NEED_TO_BE_AUDIT:片源待审核 start_time 否 String 起始时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 end_time 否 String 结束时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 page 否 Integer 分页编号。查询指定“task_id”时,该参数无效。 默认值:0。 size 否 Integer 每页记录数。查询指定“task_id”时,该参数无效。 取值范围:[1,100]。 默认值:10。
  • 响应示例 状态码:200 查询转码任务成功。 { "is_truncated" : 0, "total" : 1, "task_array" : [ { "task_id" : 22123973, "status" : "SUCCEEDED", "create_time" : 20200310031605, "end_time" : 20200310031623, "trans_template_id" : [ 4 ], "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-output.mp4" }, "output_file_name" : [ "example_480X270.m3u8" ], "transcode_detail" : { "multitask_info" : [ { "template_id" : 4, "output_file" : { "duration" : 59, "duration_ms" : 0, "format" : "HLS", "size" : 2180, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 231, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "H264" }, "audio_info" : [ { "codec" : "HEAAC", "sample" : 44100, "channels" : 2, "bitrate" : 64, "bitrate_bps" : 0 } ] } } ], "input_file" : { "duration" : 59, "duration_ms" : 0, "format" : "MOV", "size" : 2494653, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 199, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "HEVC" }, "audio_info" : [ { "codec" : "AAC", "sample" : 48000, "channels" : 2, "bitrate" : 128, "bitrate_bps" : 0 } ] } } } ] } 状态码:400 查询转码任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter" }
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 x-language 否 String 客户端语言 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 x-language 否 String 客户端语言 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 响应示例 状态码:200 查询转码任务成功。 { "is_truncated" : 0, "total" : 1, "task_array" : [ { "task_id" : 22123973, "status" : "SUCCEEDED", "create_time" : 20200310031605, "end_time" : 20200310031623, "trans_template_id" : [ 4 ], "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-output.mp4" }, "output_file_name" : [ "example_480X270.m3u8" ], "transcode_detail" : { "multitask_info" : [ { "template_id" : 4, "output_file" : { "duration" : 59, "duration_ms" : 0, "format" : "HLS", "size" : 2180, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 231, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "H264" }, "audio_info" : [ { "codec" : "HEAAC", "sample" : 44100, "channels" : 2, "bitrate" : 64, "bitrate_bps" : 0 } ] } } ], "input_file" : { "duration" : 59, "duration_ms" : 0, "format" : "MOV", "size" : 2494653, "video_info" : { "width" : 480, "height" : 270, "bitrate" : 199, "bitrate_bps" : 0, "frame_rate" : 25000, "codec" : "HEVC" }, "audio_info" : [ { "codec" : "AAC", "sample" : 48000, "channels" : 2, "bitrate" : 128, "bitrate_bps" : 0 } ] } } } ] } 状态码:400 查询转码任务失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter" }
  • URI GET /v1/{project_id}/transcodings 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。获取方法请参考“获取项目ID”章节。 表2 Query参数 参数 是否必选 参数类型 描述 task_id 否 Array of longs 转码服务接受任务后产生的任务ID。一次最多10个 status 否 String 任务执行状态。 取值如下: WAITING:等待启动 TRANSCODING:转码中 SUCCEEDED:转码成功 FAILED:转码失败 CANCELED:已删除 NEED_TO_BE_AUDIT:片源待审核 start_time 否 String 起始时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 end_time 否 String 结束时间 格式为yyyymmddhhmmss。必须是与时区无关的UTC时间,指定task_id时该参数无效 page 否 Integer 分页编号。查询指定“task_id”时,该参数无效。 默认值:0。 size 否 Integer 每页记录数。查询指定“task_id”时,该参数无效。 取值范围:[1,100]。 默认值:10。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
  • 请求参数 表3 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 Authorization 否 String 使用AK/SK方式认证时必选,携带的鉴权信息。 X-Project_Id 否 String 使用AK/SK方式认证时必选,携带项目ID信息, 与路径参数中的项目ID相同。 X-Sdk-Date 否 String 使用AK/SK方式认证时必选,请求的发生时间。
共100000条
提示

您即将访问非华为云网站,请注意账号财产安全