tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for super resolution.

Submitting Super Resolution Job

Feature description

Submitting a Super Resolution Task

Method prototype

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

Sample request

Sample 1. Using a template

<?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 {
  $result = $cosClient->createMediaSuperResolutionJobs(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' => 'SuperResolution',
      'QueueId' => 'p81e648af2aee49688570xxxxxxxxxxx',
      'Input' => array(
          'Object' => 'video01.mp4'
      ),
      'Operation' => array(
          'TemplateId' =>'t19ea5e0c0b7054d7b904axxxxxxxxxxx',
          'TranscodeTemplateId' =>'t0b612860a293f41078xxxxxxxxxxx',
          'WatermarkTemplateId' =>'t185e2e24551b24259a02xxxxxxxxxxx',
          'DigitalWatermark' => array(
              'Message' => 'xxx',
              'Type' => 'Text',
              'Version' => 'V1',
              'IgnoreError' => 'true',
          ),
          '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' => 'SuperResolution.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);
}

Sample 2. Customizing parameters

<?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 {
  $result = $cosClient->createMediaSuperResolutionJobs(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' => 'SuperResolution',
      'QueueId' => 'p81e648af2aee49688570xxxxxxxxxxx',
      'Input' => array(
          'Object' => 'video01.mp4'
      ),
      'Operation' => array(
          'SuperResolution' => array(
              'Resolution' => '',
              'EnableScaleUp' => '',
          ),
          'Transcode' => array(
              'Tag' => '',
              'Name' => '',
              'Container' => array(
                  'Format' => '',
              ),
              'Video' => array(
                  'Codec' => '',
                  'Width' => '',
                  'Height' => '',
                  'Fps' => '',
                  'Remove' => '',
                  'Profile' => '',
                  'Bitrate' => '',
                  'Crf' => '',
                  'Gop' => '',
                  'Preset' => '',
                  'Bufsize' => '',
                  'Maxrate' => '',
                  'HlsTsTime' => '',
                  'Pixfmt' => '',
                  'LongShortMode' => '',
              ),
              'TimeInterval' => array(
                  'Start' => '',
                  'Duration' => '',
              ),
              'Audio' => array(
                  'Codec' => '',
                  'Samplerate' => '',
                  'Bitrate' => '',
                  'Channels' => '',
                  'Remove' => '',
                  'KeepTwoTracks' => '',
                  'SwitchTrack' => '',
                  'SampleFormat' => '',
              ),
              'TransConfig' => array(
                  'AdjDarMethod' => '',
                  'IsCheckReso' => '',
                  'ResoAdjMethod' => '',
                  'IsCheckVideoBitrate' => '',
                  'VideoBitrateAdjMethod' => '',
                  'IsCheckAudioBitrate' => '',
                  'AudioBitrateAdjMethod' => '',
                  'DeleteMetadata' => '',
                  'IsHdr2Sdr' => '',
                  'HlsEncrypt' => array(
                      'IsHlsEncrypt' => '',
                      'UriKey' => '',
                  ),
              ),
          ),
          'Watermark' => array(
              'Type' => '',
              'Pos' => '',
              'LocMode' => '',
              'Dx' => '',
              'Dy' => '',
              'StartTime' => '',
              'EndTime' => '',
              'Image' => array(
                  'Url' => '',
                  'Mode' => '',
                  'Width' => '',
                  'Height' => '',
                  'Transparency' => '',
                  'Background' => '',
              ),
              'Text' => array(
                  'FontSize' => '',
                  'FontType' => '',
                  'FontColor' => '',
                  'Transparency' => '',
                  'Text' => '',
              ),
          ),
          'DigitalWatermark' => array(
              'Message' => '',
              'Type' => '',
              'Version' => '',
              'IgnoreError' => '',
          ),
          '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' => 'SuperResolution.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 a super resolution job, you must pass in the transcoding parameter. For the super resolution parameter, TemplateId is used first, and if TemplateId is unavailable, SuperResolution is used. 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.

SuperResolution has the following sub-nodes:

Transcode has the following sub-nodes:

DigitalWatermark 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] => NjI2OGY4ZDdfZmNjYTNiMGAJODIJAOIDJAOMmVmNDU=
  [ContentType] => application/xml
  [ContentLength] => 1170
  [Bucket] => examplebucket-1250000000
  [Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/jobs
  [Response] => Array
      (
          [JobsDetail] => Array
              (
                  [Code] => Success
                  [CreationTime] => 2022-04-27T16:03:35+0800
                  [EndTime] => -
                  [Input] => Array
                      (
                          [BucketId] => examplebucket-1250000000
                          [Object] => video01.mp4
                          [Region] => ap-guangzhou
                      )
                   [JobId] => j89be22b8c60011ec9070fasd8a09d80a9b8
                  [Message] => 
                  [Operation] => Array
                      (
                          [DigitalWatermark] => Array
                              (
                                  [IgnoreError] => true
                                  [Message] => xxx
                                  [State] => Running
                                  [Type] => Text
                                  [Version] => V1
                              )
                           [Output] => Array
                              (
                                  [Bucket] => examplebucket-1250000000
                                  [Object] => SuperResolution.flv
                                  [Region] => ap-guangzhou
                              )
                           [TemplateId] => t19ea5e0c0b7b904a8sd09a8sd09a80sd10
                          [TemplateName] => SuperResolution-1
                          [TranscodeTemplateId] => t19ea5e0c0b7b904a8sd09a8sd09a80sd10
                          [WatermarkTemplateId] => t19ea5e0c0b7b904a8sd09a8asdasddsd10
                          [UserData] => xxx
                          [JobLevel] => 0
                      )
                   [QueueId] => p81e648af2aee49688570asd8a90sd6
                  [StartTime] => -
                  [State] => Submitted
                  [Tag] => SuperResolution
              )
       )
)