tencent cloud

Overview

This document provides an overview of APIs and SDK code samples for transcoding job submission.

Submitting Transcoding Job

Feature description

This API is used to submit a transcoding job.

Method prototype

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

Sample request

Sample 1. Using a template

<?php
require dirname(__FILE__) . '/../vendor/autoload.php';
$secretId = "SECRETID"; // Replace it with your real `secretId`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; // Replace it with your real `secretKey`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; // Replace it with your real region information, which can be viewed in the console at https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is `http` by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->createMediaTranscodeJobs(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-Appid`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
      'Tag' => 'Transcode',
      'QueueId' => 'paaf4fce5521a40888a3034a5de80f6ca',
      'Input' => array(
          'Object' => 'example.mp4'
      ),
      'Operation' => array(
          'TemplateId' => 't04e1ab86554984f1aa17c062fbf6c007c',
          '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.intl.cloud.tencent.com/cos5/bucket
              'Object' => 'video02.mp4',
          ),
          'Watermark' => array(
              array(
                  'Type' => 'Text',
                  'LocMode' => 'Absolute',
                  'Dx' => '64',
                  'Dy' => '64',
                  'Pos' => 'TopRight',
                  'Text' => array(
                      'Text' => 'The first watermark',
                      'FontSize' => '30',
                      'FontType' => 'simfang.ttf',
                      'FontColor' => '#99ff00',
                      'Transparency' => '100', // Opacity
                   ),
              ),
              array(
                  'Type' => 'Text',
                  'LocMode' => 'Absolute',
                  'Dx' => '64',
                  'Dy' => '64',
                  'Pos' => 'TopLeft',
                  'Text' => array(
                      'Text' => 'The second watermark',
                      'FontSize' => '30',
                      'FontType' => 'simfang.ttf',
                      'FontColor' => '#99ff00',
                      'Transparency' => '100', // Opacity
                   ),
              ),
          ),
      ),
  ));
  // Request successful
  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 your real `secretId`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; // Replace it with your real `secretKey`, which can be viewed and managed in the CAM console at https://console.intl.cloud.tencent.com/cam/capi
$region = "ap-beijing"; // Replace it with your real region information, which can be viewed in the console at https://console.intl.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\Cos\Client(
  array(
      'region' => $region,
      'schema' => 'https', // Protocol header, which is `http` by default
      'credentials'=> array(
          'secretId'  => $secretId ,
          'secretKey' => $secretKey)));
try {
  $result = $cosClient->createMediaTranscodeJobs(array(
      'Bucket' => 'examplebucket-1250000000', // Bucket name in the format of `BucketName-Appid`, which can be viewed in the COS console at https://console.intl.cloud.tencent.com/cos5/bucket
      'Tag' => 'Transcode',
      'QueueId' => 'asdadadfafsdkjhfjghdfjg',
      'CallBack' => 'https://example.com/callback',
      'Input' => array(
          'Object' => 'video01.mp4'
      ),
      'Operation' => array(
          '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.intl.cloud.tencent.com/cos5/bucket
              'Object' => 'video01.mkv',
          ),
          'Transcode' => array(
              'Container' => array(
                  'Format' => 'mp4'
              ),
              'Video' => array(
                  'Codec' => 'H.264',
                  'Profile' => 'high',
                  'Bitrate' => '1000',
                  'Preset' => 'medium',
                  'Width' => '1280',
                  'Fps' => '30',
              ),
              'Audio' => array(
                  'Codec' => 'aac',
                  'Samplerate' => '44100',
                  'Bitrate' => '128',
                  'Channels' => '4',
              ),
              'TransConfig' => array(
                  'AdjDarMethod' => 'scale',
                  'IsCheckReso' => 'false',
                  'ResoAdjMethod' => '1',
              ),
              'TimeInterval' => array(
                  'Start' => '0',
                  'Duration' => '60',
              ),
          ),
      ),
  ));
  // Request successful
  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：

TemplateId is used with priority. If TemplateId is unavailable, the corresponding job type parameter is used.

Transcode has the following sub-nodes:

RemoveWatermark 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] => NjI2MTAzasdaHUISDHUINzE3YV8xZWVmNjU=
  [ContentType] => application/xml
  [ContentLength] => 1554
  [Bucket] => examplebucket-12500000000
  [Location] => examplebucket-12500000000.cos.ap-guangzhou.myqcloud.com/jobs
  [Response] => Array
      (
          [JobsDetail] => Array
              (
                  [Code] => Success
                  [CreationTime] => 2022-04-21T15:10:15+0800
                  [EndTime] => -
                  [Input] => Array
                      (
                          [BucketId] => examplebucket-12500000000
                          [Object] => video01.mp4
                          [Region] => ap-beijing
                      )
                   [JobId] => j1815a4c81h2kj31231gh31kj2f9e223404e
                  [Message] => Array
                      (
                      )
                   [Operation] => Array
                      (
                          [Output] => Array
                              (
                                  [Bucket] => examplebucket-12500000000
                                  [Object] => Transcode.flv
                                  [Region] => ap-beijing
                              )
                           [TemplateId] => t0b612860as90d8a09sd65dca38
                          [TemplateName] => FLV-SD
                          [Watermark] => Array
                              (
                                  [0] => Array
                                      (
                                          [Dx] => 64
                                          [Dy] => 64
                                          [EndTime] => Array
                                              (
                                              )
                                           [LocMode] => Absolute
                                          [Pos] => TopRight
                                          [StartTime] => Array
                                              (
                                              )
                                           [Text] => Array
                                              (
                                                  [FontColor] => #99ff00
                                                  [FontSize] => 30
                                                  [FontType] => simfang.ttf
                                                  [Text] => The first watermark
                                                  [Transparency] => 100
                                              )
                                           [Type] => Text
                                      )
                                   [1] => Array
                                      (
                                          [Dx] => 64
                                          [Dy] => 64
                                          [EndTime] => Array
                                              (
                                              )
                                           [LocMode] => Absolute
                                          [Pos] => TopLeft
                                          [StartTime] => Array
                                              (
                                              )
                                           [Text] => Array
                                              (
                                                  [FontColor] => #99ff00
                                                  [FontSize] => 30
                                                  [FontType] => simfang.ttf
                                                  [Text] => The second watermark
                                                  [Transparency] => 100
                                              )
                                           [Type] => Text
                                      )
                               )
                       )
                   [Progress] => 0
                  [QueueId] => p81e648a7s9d88a09sd89a0757be086
                  [StartTime] => -
                  [State] => Submitted
                  [Tag] => Transcode
              )
       )
)