tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for SDR-to-HDR jobs.

Submitting SDR-to-HDR Job

Feature description

This API is used to submit an SDR-to-HDR job.

Method prototype

public Guzzle\Service\Resource\Model createMediaSDRtoHDRJobs(array $args = array());

Sample request

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; //Replace it with the actual `SecretId`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$secretKey = "SECRETKEY"; //Replace it with the actual `SecretKey`, which can be viewed and managed in the CAM console at https://console.tencentcloud.com/cam/capi
$region = "ap-beijing"; // Replace it with the actual region, which can be viewed in the console at https://console.tencentcloud.com/cos5/bucket.
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol, which is `http` by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  // Submit an SDR-to-HDR job. For more information, visit https://www.tencentcloud.com/document/product/436/49052.
  $result = $cosClient->createMediaSDRtoHDRJobs(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-Appid`, which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket.
      'Tag' => 'SDRtoHDR',
      'QueueId' => 'p81e648af2aee496885a8d09a8s09d8a0sd6',
      'Input' => array(
          'Object' => 'video01.mp4'
      ),
      'Operation' => array(
          'TranscodeTemplateId' => '',
          'WatermarkTemplateId' => '',
          'SDRtoHDR' => array(
              'HdrMode' => 'HLG',
          ),
          'Output' => array(
              'Region' => $region,
              'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-Appid`, which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket.
              'Object' => 'SDRtoHDR.flv',
          ),
//            'UserData' => 'xxx', // The user information passed through.
//            'JobLevel' => '0', // Job priority. The greater the value, the higher the priority. Valid values: `0`, `1`, `2`. Default value: `0`.
      ),
      'CallBack' => '',
  ));
  // Request succeeded
  print_r($result);
} catch (\Exception $e) {
  // Request failed
  echo($e);
}

Parameter description

Request has the following sub-nodes:

Input has the following sub-nodes:

Operation has the following sub-nodes:

Note：

To submit an SDR-to-HDR job, you must pass in the transcoding parameter. For the transcoding parameter, TranscodeTemplateId is used first, and if TranscodeTemplateId is unavailable, Transcode is used. For the watermark parameter, WatermarkTemplateId or Watermark can be used for configuration, and WatermarkTemplateId is used first.

SDRtoHDR has the following sub-nodes:

Transcode has the following sub-nodes:

Output has the following sub-nodes:

Sample response

GuzzleHttp\Command\Result Object
(
  [Body] => GuzzleHttp\Psr7\Stream Object
      (
          [stream:GuzzleHttp\Psr7\Stream:private] => Resource id #88
          [size:GuzzleHttp\Psr7\Stream:private] => 
          [seekable:GuzzleHttp\Psr7\Stream:private] => 1
          [readable:GuzzleHttp\Psr7\Stream:private] => 1
          [writable:GuzzleHttp\Psr7\Stream:private] => 1
          [uri:GuzzleHttp\Psr7\Stream:private] => php://temp
          [customMetadata:GuzzleHttp\Psr7\Stream:private] => Array
              (
              )
       )
   [RequestId] => NjI2N2I1NWFfZmNjYTNHDOASJDOIA1Yw==
  [ContentType] => application/xml
  [ContentLength] => 902
  [Bucket] => examplebucket-1250000000
  [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/jobs
  [Response] => Array
      (
          [JobsDetail] => Array
              (
                  [Code] => Success
                  [CreationTime] => 2022-04-26T17:03:22+0800
                  [EndTime] => -
                  [Input] => Array
                      (
                          [BucketId] => examplebucket-1250000000
                          [Object] => video01.mp4
                          [Region] => ap-guangzhou
                      )
                   [JobId] => jb9289626c53f11ec8a9c4f3d8d099dcb
                  [Message] => 
                  [Operation] => Array
                      (
                          [Output] => Array
                              (
                                  [Bucket] => examplebucket-1250000000
                                  [Object] => SDRtoHDR.flv
                                  [Region] => ap-guangzhou
                              )
                           [SDRtoHDR] => Array
                              (
                                  [HdrMode] => HLG
                              )
                           [TranscodeTemplateId] => t0b612860a293f410785ba7s8d09a8d09a38
                          [WatermarkTemplateId] => t185e2e24551b242d09a80d8a0d80428a19c
                          [UserData] => xxx
                          [JobLevel] => 0
                      )
                   [QueueId] => t185e2e24551b242d09a80d8a0d80428a19c
                  [StartTime] => -
                  [State] => Submitted
                  [Tag] => SDRtoHDR
              )
       )
)