Release Notes
Announcements
ci:CreateMediaJobs permission is required. For details, see Cloud Infinite actions.cam:passrole permission is required. The asynchronous processing interface performs COS resource read and write operations through CAM's "role". The PassRole permission is used for role passing. For details, refer to Access Management - Write Operations - PassRole API.POST /jobs HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
<Request><Tag>Transcode</Tag><Input><Object>input/demo.mp4</Object></Input><Operation><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON<CallBackFormat></Request>
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
Request | None. | Container for saving requests | Container | Yes |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
Tag | Request | Create task Tag: Transcode | String | Yes |
Input | Request | File information to be operated | Container | Yes |
Operation | Request | Operation rule | Container | Yes |
CallBackFormat | Request | Job callback format, JSON or XML, default XML, priority is higher than the callback format of the queue | String | No |
CallBackType | Request | Job callback type, Url or TDMQ, default Url, priority is higher than the callback type of the queue | String | No |
CallBack | Request | Job callback address, priority is higher than the queue's callback address. When set to no, it indicates that the queue's callback address does not generate callbacks. | String | No |
CallBackMqConfig | Request | Task callback TDMQ configuration, required when CallBackType is TDMQ. For details, see CallBackMqConfig. | Container | No |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
Object | Request.Input | File path | String | Yes |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
TemplateId | Request.Operation | transcoding template ID | String | No |
Transcode | Request.Operation | transcoding template parameter | Container | No |
RemoveWatermark | Request.Operation | Remove watermark parameter H265, AV1 encoding do not support this parameter | Container | No |
Output | Request.Operation | Output configuration for results | Container | Yes |
UserData | Request.Operation | Pass through user information Printable ASCII code Length not exceeding 1024 | String | No |
JobLevel | Request.Operation | Task priority Level limit: 0, 1, 2. Higher level means higher task priority. Default is 0. | String | No |
FreeTranscode | Request.Operation | off-peak transcoding flag, true/false | String | No |
Node Name (Keyword) | Parent Node | Description | Type | Required | Limit |
Container | Request.Operation.Transcode | container format | Container | Yes | None. |
Video | Request.Operation.Transcode | video information | Container | No | Not passing Video is equivalent to deleting video information. |
TimeInterval | Request.Operation.Transcode | Time interval | Container | No | None. |
Audio | Request.Operation.Transcode | audio content | Container | No | Not passing Audio is equivalent to deleting audio information. |
TransConfig | Request.Operation.Transcode | transcoding configuration | Container | No | None. |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
Format | Request.Operation.Transcode.Container | Encapsulation format: The values are as follows in the table below | String | Yes |
Container | Audio Codecs | Video Codecs |
mp4 | aac,mp3 | H.264,H.265,AV1 |
hls | aac,mp3 | H.264,H.265 |
flv | aac,mp3 | H.264 |
mp3 | mp3 | Not supported |
flac | flac | Not supported |
m4a | aac | Not supported |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not | Default Value | Limit |
Codec | Request.Operation.Transcode.Video | Encoding/Decoding Format | String | No | H.264 | H.264 H.265 AV1 |
Fps | Request.Operation.Transcode.Video | Frame Rate | String | No | None. | Value range: (0, 60] Unit: fps |
Bitrate | Request.Operation.Transcode.Video | Bitrate of the video output file | String | No | None. | Value range: [128, 35000] Unit: Kbps |
Width | Request.Operation.Transcode.Video | Wide | String | No | Original width of the video | Value range: [128, 4096] Unit: px If only Width is set, calculate Height based on the video's original aspect ratio. Must be even |
Height | Request.Operation.Transcode.Video | High | String | No | Original height of the video | Value range: [128, 4096] Unit: px If only Height is set, calculate Width based on the video's original aspect ratio. Must be even |
Gop | Request.Operation.Transcode.Video | Maximum frames between key frames | String | No | None. | Value range: [1, 100000] |
Crf | Request.Operation.Transcode.Video | bitrate - quality control factor | String | No | None. | Value range: (0, 51] If Crf is set, the setting of Bitrate becomes invalid. When Bitrate is empty, it defaults to 25. |
Remove | Request.Operation.Transcode.Video | Whether to remove the video stream | String | No | false | true, false, cannot be true at the same time as Audio.Remove |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not | Default Value | Limit |
Codec | Request.Operation.Transcode.Audio | Encoding/Decoding Format | String | No | aac | aac,mp3,flac |
Bitrate | Request.Operation.Transcode.Audio | Original audio bitrate | String | No | None. | Unit: Kbps Value range: [26, 256] |
Samplerate | Request.Operation.Transcode.Audio | sampling rate | String | No | 44100 | 44100 |
Channels | Request.Operation.Transcode.Audio | number of sound channels | String | No | 2 | 1,2 |
Remove | Request.Operation.Transcode.Audio | Whether to delete the source audio stream | String | No | false | true, false, cannot be true at the same time as Video.Remove |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not | Default Value | Limit |
Start | Request.Operation.Transcode.TimeInterval | Start Time | String | No | 0 | video duration Unit: seconds Support float format, with execution accuracy accurate to milliseconds |
Duration | Request.Operation.Transcode.TimeInterval | Duration | String | No | original video duration | video duration in seconds Support float format, execution accuracy accurate to milliseconds |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not | Default Value | Limit |
AdjDarMethod | Request.Operation.Transcode.TransConfig | Resolution adjustment method | String | No | None. | scale (stretch) pad (black border fill) When the aspect ratio of the output video differs from that of the original video, adjust the resolution according to this parameter |
Node Name (Keyword) | Parent Node | Description | Type | Required |
Dx | Request.Operation.RemoveWatermark | Offset from the top-left corner origin point in the x-direction, range [1, 4096] | string | Yes |
Dy | Request.Operation.RemoveWatermark | y offset from the top-left origin point, range [1, 4096] | string | Yes |
Width | Request.Operation.RemoveWatermark | Width, range [1, 4096] | string | Yes |
Height | Request.Operation.RemoveWatermark | Height, range [1, 4096] | string | Yes |
Node Name (Keyword) | Parent Node | Description | Type | Required or Not |
Region | Request.Operation.Output | Region of the bucket | String | Yes |
Bucket | Request.Operation.Output | Bucket for storing results | String | Yes |
Object | Request.Operation.Output | Output result filename | String | Yes |
Wildcard | Meaning |
${ext} | encapsulation format |
${jobid} | task Id |
<Response><JobsDetail><Code>Success</Code><Message/><JobId>j8d121820f5e411ec926ef19d53ba9c6f</JobId><State>Submitted</State><Progress>0</Progress><CreationTime>2022-06-27T15:23:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>p2242ab62c7c94486915508540933a2c6</QueueId><Tag>Transcode</Tag><Input><BucketId>test-123456789</BucketId><Object>input/demo.mp4</Object><Region>ap-chongqing</Region></Input><Operation><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><TemplateName>trans_993874</TemplateName><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
Node Name (Keyword) | Parent Node | Description | Type |
Response | None. | Container for saving results | Container |
Node Name (Keyword) | Parent Node | Description | Type |
JobsDetail | Response | Task details | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Code | Response.JobsDetail | Error code, which is meaningful only when State is Failed. | String |
Message | Response.JobsDetail | Error description, which is meaningful only when State is Failed. | String |
JobId | Response.JobsDetail | ID of the newly created task | String |
Tag | Response.JobsDetail | Tag of the newly created task: Transcode | String |
State | Response.JobsDetail | Task status, one of Submitted, Running, Success, Failed, Pause, Cancel. | String |
Progress | Response.JobsDetail | Task progress percentage, meaningful only when State is Submitted, Running, Success, or Pause, range [0, 100]. | String |
CreationTime | Response.JobsDetail | Task creation time | String |
StartTime | Response.JobsDetail | Task start time | String |
EndTime | Response.JobsDetail | Task end time | String |
QueueId | Response.JobsDetail | Task's queue ID | String |
Input | Response.JobsDetail | Input resource address of the task | Container |
Operation | Response.JobsDetail | Operation rule | Container |
Node Name (Keyword) | Parent Node | Description | Type |
Region | Response.JobsDetail.Input | Region of the bucket | String |
Bucket | Response.JobsDetail.Input | Bucket for storing results | String |
Object | Response.JobsDetail.Input | Filename of the output result | String |
Node Name (Keyword) | Parent Node | Description | Type |
TemplateId | Response.JobsDetail.Operation | Job template ID | String |
TemplateName | Response.JobsDetail.Operation | Task template name, return when TemplateId exists | String |
Transcode | Response.JobsDetail.Operation | in-progress Request's Operation.Transcode | Container |
Watermark | Response.JobsDetail.Operation | Request.Operation.Watermark | Container array |
RemoveWatermark | Response.JobsDetail.Operation | Remove watermark from in-progress Request | Container |
WatermarkTemplateId | Response.JobsDetail.Operation | watermark template ID | String array |
Output | Response.JobsDetail.Operation | In-progress Request's Operation.Output | Container |
MediaInfo | Response.JobsDetail.Operation | Output file's media information, do not return if the task is incomplete | Container |
MediaResult | Response.JobsDetail.Operation | Basic information of the output file, do not return if the task is incomplete | Container |
DigitalWatermark | Response.JobsDetail.Operation | Request.Operation.DigitalWatermark | Container |
UserData | Response.JobsDetail.Operation | Pass through user information | String |
JobLevel | Response.JobsDetail.Operation | Task priority | String |
POST /jobs HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=**********************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=**************************************Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml<Request><Tag>Transcode</Tag><Input><Object>input/demo.mp4</Object></Input><Operation><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON<CallBackFormat></Request>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><JobsDetail><Code>Success</Code><Message/><JobId>j8d121820f5e411ec926ef19d53ba9c6f</JobId><State>Submitted</State><Progress>0</Progress><CreationTime>2022-06-27T15:23:11+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>p2242ab62c7c94486915508540933a2c6</QueueId><Tag>Transcode</Tag><Input><BucketId>test-123456789</BucketId><Object>input/demo.mp4</Object><Region>ap-chongqing</Region></Input><Operation><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><TemplateName>trans_993874</TemplateName><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe22</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe23</WatermarkTemplateId><WatermarkTemplateId>t1318c5f428d474afba1797f84091cbe24</WatermarkTemplateId><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
POST /jobs HTTP/1.1Authorization:q-sign-algorithm=sha1&q-ak=**********************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=**************************************Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml<Request><Tag>Transcode</Tag><Input><Object>input/demo.mp4</Object></Input><Operation><Transcode><Container><Format>mp4</Format></Container><Video><Codec>H.264</Codec><Profile>high</Profile><Bitrate>1000</Bitrate><Width>1280</Width><Fps>30</Fps><Preset>medium</Preset></Video><Audio><Codec>aac</Codec><Samplerate>44100</Samplerate><Bitrate>128</Bitrate><Channels>4</Channels></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></Transcode><Watermark><Type>Text</Type><LocMode>Absolute</LocMode><Dx>128</Dx><Dy>128</Dy><Pos>TopRight</Pos><StartTime>0</StartTime><EndTime>100.5</EndTime><Text><Text>Watermark content</Text><FontSize>30</FontSize><FontType>simfang.ttf</FontType><FontColor>0xRRGGBB</FontColor><Transparency>30</Transparency></Text></Watermark><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation><CallBack>http://callback.demo.com</CallBack><CallBackFormat>JSON<CallBackFormat></Request>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><JobsDetail><Code>Success</Code><Message/><JobId>j8d121820f5e411ec926ef19d53ba9c6f</JobId><State>Submitted</State><Progress>0</Progress><CreationTime>2022-06-27T15:23:10+0800</CreationTime><StartTime>-</StartTime><EndTime>-</EndTime><QueueId>p2242ab62c7c94486915508540933a2c6</QueueId><Tag>Transcode</Tag><Input><BucketId>test-123456789</BucketId><Object>input/demo.mp4</Object><Region>ap-chongqing</Region></Input><Operation><Transcode><Container><Format>mp4</Format></Container><Video><Codec>H.264</Codec><Profile>high</Profile><Bitrate>1000</Bitrate><Width>1280</Width><Fps>30</Fps><Preset>medium</Preset></Video><Audio><Codec>aac</Codec><Samplerate>44100</Samplerate><Bitrate>128</Bitrate><Channels>4</Channels></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></Transcode><Watermark><Type>Text</Type><LocMode>Absolute</LocMode><Dx>128</Dx><Dy>128</Dy><Pos>TopRight</Pos><StartTime>0</StartTime><EndTime>100.5</EndTime><Text><Text>Watermark content</Text><FontSize>30</FontSize><FontType></FontType><FontColor>0xRRGGBB</FontColor><Transparency>30</Transparency></Text></Watermark><RemoveWatermark><Dx>150</Dx><Dy>150</Dy><Width>75</Width><Height>75</Height></RemoveWatermark><DigitalWatermark><Type>Text</Type><Message>123456789ab</Message><Version>V1</Version><IgnoreError>false</IgnoreError><State>Running</State></DigitalWatermark><Output><Region>ap-chongqing</Region><Bucket>test-123456789</Bucket><Object>output/out.${ext}</Object></Output><UserData>This is my data.</UserData><JobLevel>0</JobLevel></Operation></JobsDetail></Response>
Esta página foi útil?
Você também pode entrar em contato com a Equipe de vendas ou Enviar um tíquete em caso de ajuda.
comentários