동향 및 공지

릴리스 노트

제품 공지

제품 소개

제품 개요

기능 개요

적용 시나리오

제품 장점

기본 개념

리전 및 액세스 도메인

규격 및 제한

제품 요금

과금 개요

과금 방식

과금 항목

프리 티어

과금 예시

청구서 보기 및 다운로드

연체 안내

FAQ

빠른 시작

콘솔 시작하기

COSBrowser 시작하기

사용자 가이드

요청 생성

버킷

객체

데이터 관리

일괄 프로세스

글로벌 가속

모니터링 및 알람

운영 센터

데이터 처리

스마트 툴 박스 사용 가이드

데이터 워크플로

애플리케이션 통합

툴 가이드

툴 개요

환경 설치 및 설정

COSBrowser 툴

COSCLI 툴

COSCMD 툴

COS Migration 툴

FTP Server 툴

Hadoop 툴

COSDistCp 툴

HDFS TO COS 툴

온라인 도구 (Onrain Dogu)

자가 진단 도구

실습 튜토리얼

개요

액세스 제어 및 권한 관리

성능 최적화

AWS S3 SDK를 사용하여 COS에 액세스하기

데이터 재해 복구 백업

도메인 관리 사례

이미지 처리 사례

COS 오디오/비디오 플레이어 사례

데이터 다이렉트 업로드

데이터 보안

데이터 검증

빅 데이터 사례

COS 비용 최적화 솔루션

3rd party 애플리케이션에서 COS 사용

마이그레이션 가이드

로컬 데이터 COS로 마이그레이션

타사 클라우드 스토리지 데이터를 COS로 마이그레이션

URL이 소스 주소인 데이터를 COS로 마이그레이션

COS 간 데이터 마이그레이션

Hadoop 파일 시스템과 COS 간 데이터 마이그레이션

데이터 레이크 스토리지

클라우드 네이티브 데이터 레이크

메타데이터 가속

데이터 레이크 가속기 GooseFS

데이터 처리

데이터 처리 개요

이미지 처리

미디어 처리

콘텐츠 조정

파일 처리

문서 미리보기

장애 처리

RequestId 가져오기

공용 네트워크로 COS에 파일 업로드 시 속도가 느린 문제

COS 액세스 시 403 에러 코드 반환

리소스 액세스 오류

POST Object 자주 발생하는 오류

보안 및 컴플라이언스

데이터 재해 복구

데이터 보안

액세스 관리

자주 묻는 질문

Submit Tasks

포커스 모드

폰트 크기

마지막 업데이트 시간: 2026-01-12 18:52:37

Feature Overview
Submit a video synthesis task.
Authorization Guide
When used with a sub-account, the ci:CreateMediaJobs permission must be granted. For details, please refer to Cloud Infinite.
When a sub-account uses an asynchronous processing interface, the cam:PassRole permission must be granted. The asynchronous processing interface performs read and write operations on COS resources through the "role" in CAM. The PassRole permission is used for role passing. For details, refer to Cloud Access Management > Write Operation > PassRole API.
Service Activation
Using this feature requires enabling Cloud Infinite in advance and binding a bucket. For details, see Bind Bucket.
Using this feature requires enabling Media Processing Service in advance through console or API. For details, see Enable Media Processing Service.
Use Limits
When using this API, please first confirm the relevant restrictions. For details, see Specifications and Limits.
Fee Description
This API is a paid service. The incurred fees will be collected by Cloud Infinite. For detailed billing information, see Media Processing Fees.
Request
Request Sample
POST /jobs HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml
﻿
<body>
Note:
Authorization: Auth String. For details, see Request Signature documentation.
Request Header
This API only uses common request headers. For details, see Common Request Headers documentation.
Request Body
The implementation of this request operation requires the following request body.
<Request>
    <Tag>VideoSynthesis</Tag>
    <Operation>
        <TranscodeTemplateId>t160606b9752148c4absdfaf2f55163b1f</TranscodeTemplateId>
        <WatermarkTemplateId>t146d70eb241c44c63b6efc1cc93ccfc5d</WatermarkTemplateId>
        <VideoSynthesis>
            <KeepAudioTrack>false</KeepAudioTrack>
            <SpliceInfo>
                <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4</Url>
                <Width>640</Width>
            </SpliceInfo>
            <SpliceInfo>
                <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4</Url>
                <X>700</X>
                <Width>640</Width>
                <Height>960</Height>
            </SpliceInfo>
        </VideoSynthesis>
        <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>
The data are described as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
Request
None
Container for saving requests
Container
Yes
The data description of container Request is as follows:
Node Name
(Keyword)
Parent Node
Description
Type
Required 
Tag
Request
Tag for creating a task: VideoSynthesis
String
Yes
Operation
Request
Operation rule
Container
Yes
CallBackFormat
Request
Task callback format, JSON or XML, default XML, which has a higher priority than the callback format of the queue
String
No
CallBackType
Request
Task callback type, URL or TDMQ, default URL, which has a higher priority than the callback type of the queue
String
No
CallBack
Request
Task callback address, which has a higher priority than the callback address of the queue. When set to "no", the callback address will not trigger a callback.
String
No
CallBackMqConfig
Request
Task callback TDMQ configuration, required when CallBackType is TDMQ. For details, see CallBackMqConfig.
Container
No
The data description of container Operation
 is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
VideoSynthesis
Request.Operation
Video synthesis template parameter
Container
Yes
TranscodeTemplateId
Request.Operation
Transcoding template ID
String
No
Transcode
Request.Operation
Transcoding template parameter
Container
No
WatermarkTemplateId
Request.Operation
Watermark template ID, you can pass multiple watermark template IDs, with a maximum of 3.
String array
No
Watermark
Request.Operation
Watermark template parameters, same as Request.Watermark in the create watermark template API, you can submit maximum of 3.
Container array
No
Output
Request.Operation
Output configuration
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 indicate higher task priority, default is 0.
String
No
Note:
Transcoding parameters must be set. They can be configured through TranscodeTemplateId or Transcode, with TranscodeTemplateId having higher priority.
Watermark parameters are optional, can be set through WatermarkTemplateId or Watermark, WatermarkTemplateId has higher priority.
Transcode.Video.Width and Transcode.Video.Height in transcoding template parameters/transcoding parameters are mandatory.
The data description of container VideoSynthesis is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
KeepAudioTrack
Request.Operation.VideoSynthesis
Retain the source video audio track, parameter value: true/false, default value: false
String
No
SpliceInfo
Request.Operation.VideoSynthesis
Video to be synthesized
Container array
Yes
The data description of container SpliceInfo is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
URL
Request.Operation.VideoSynthesis.SpliceInfo
Video file URL in the same bucket
String
Yes
X
Request.Operation.VideoSynthesis.SpliceInfo
The horizontal coordinate of the video in the display frame, default value 0
String
No
Y
Request.Operation.VideoSynthesis.SpliceInfo
The vertical coordinate of this video in the display frame, default value 0
String
No
Width
Request.Operation.VideoSynthesis.SpliceInfo
The width of the video in the display frame, default to the original video width
String
No
Height
Request.Operation.VideoSynthesis.SpliceInfo
The height of the video in the display frame, default to the original video height
String
No
Name
Request.Operation.VideoSynthesis.SpliceInfo
Custom name of the video stream, length not exceeding 64 characters, only supports Chinese, English, digits, _, -, and *
String
No
The data description of container Transcode is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required 
TimeInterval
Request.Operation.Transcode
Same as Request.TimeInterval in the CreateTranscodeTemplate API.
Container
No
Container
Request.Operation.Transcode
Same as Request.Container in the CreateTranscodeTemplate API.
Container
No
Video
Request.Operation.Transcode
Same as Request.Video in the CreateTranscodeTemplate API.
Container
No
Audio
Request.Operation.Transcode
Same as Request.Audio in the CreateTranscodeTemplate API.
Container
No
TransConfig
Request.Operation.Transcode
Same as Request.TransConfig in the CreateTranscodeTemplate API.
Container
No
AudioMix
Request.Operation.Transcode
Audio mixing parameter, for details, see AudioMix﻿
Container
No
AudioMixArray
Request.Operation.Transcode
Audio mixing parameter array, supports up to 2 simultaneous submissions
Container array
No
Note:
Not passing Video is equivalent to deleting video information. Not passing Audio is equivalent to deleting audio information. Video and Audio cannot both be omitted at the same time.
AudioMix and AudioMixArray take effect when Audio.Remove is false.
AudioMixArray is an array, and the content of each sub-item is the same as AudioMix. AudioMix has higher priority. When AudioMix is set, AudioMixArray is invalid.
The data description of container Output is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
Region
Request.Operation.Output
Region of the storage bucket
String
Yes
Bucket
Request.Operation.Output
Bucket for storing results
String
Yes
Object
Request.Operation.Output
Filename of the output result
String
Yes
Wildcard characters supported by Request.Operation.Output.Object are as follows:
Wildcard
Meaning
${ext}
Encapsulation format
${jobid}
Task ID
Response
Response Header
This API only returns common response headers. For details, see Common Response Headers documentation.
Response Body
The response body is returned as application/xml. An example including the complete node data is shown below:
<Response>
    <JobsDetail>
        <Code>Success</Code>
        <Message/>
        <JobId>j8d121820f5e411ec926ef19d53ba9c6f</JobId>
        <State>Submitted</State>
        <CreationTime>2022-06-27T14:44:10+0800</CreationTime>
        <StartTime>-</StartTime>
        <EndTime>-</EndTime>
        <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
        <Tag>VideoSynthesis</Tag>
        <Operation>
            <TranscodeTemplateId>t160606b9752148c4absdfaf2f55163b1f</TranscodeTemplateId>
            <WatermarkTemplateId>t146d70eb241c44c63b6efc1cc93ccfc5d</WatermarkTemplateId>
            <VideoSynthesis>
                <KeepAudioTrack>false</KeepAudioTrack>
                <SpliceInfo>
                    <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4</Url>
                    <Width>640</Width>
                </SpliceInfo>
                <SpliceInfo>
                    <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4</Url>
                    <X>700</X>
                    <Width>640</Width>
                    <Height>960</Height>
                </SpliceInfo>
            </VideoSynthesis>
            <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>
The data content is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None
Container for saving results
Container
The content of container node Response:
Node Name (Keyword)
Parent Node
Description
Type
JobsDetail
Response
Task detailed information
Container array
The content of container node JobsDetail
:
Node Name (Keyword)
Parent Node
Description
Type
Code
Response.JobsDetail
Error code, which takes effect when State is Failed
String
Message
Response.JobsDetail
Error description, which takes effect when State is Failed
String
JobId
Response.JobsDetail
ID of the newly created task
String
Tag
Response.JobsDetail
Tag for newly created task: VideoSynthesis
String
State
Response.JobsDetail
Task Status
Submitted: submitted, pending execution
Running: executing
Success: execution successful
Failed: execution failed
Pause: Task pause. When the pause queue is triggered, to-be-executed tasks become paused state.
Cancel: task cancelled
String
Progress
Response.JobsDetail
Task progress percentage, takes effect 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
﻿Queue ID of the task
String
Operation
Response.JobsDetail
Operation rule
Container
The content of container node Input:
Node Name (Keyword)
Parent Node
Description
Type
Region
Response.JobsDetail.Input
Region of the storage bucket
String
Bucket
Response.JobsDetail.Input
Bucket for storing results
String
Object
Response.JobsDetail.Input
Filename of the output result
String
The content of container node Operation:
Node Name (Keyword)
Parent Node
Description
Type
VideoSynthesis
Response.JobsDetail.Operation
Same as Request.Operation.VideoSynthesis in the Request body
Container
TranscodeTemplateId
Response.JobsDetail.Operation
Same as Request.Operation.TranscodeTemplateId in the Request body
String
Transcode
Response.JobsDetail.Operation
Same as Request.Operation.Transcode in the Request body
Container
Watermark
Response.JobsDetail.Operation
Same as Request.Operation.Watermark in the Request body
Container array
WatermarkTemplateId
Response.JobsDetail.Operation
Same as Request.Operation.WatermarkTemplateId in the Request body
String array
Output
Response.JobsDetail.Operation
Same as Request.Operation.Output in the Request body
Container
MediaInfo
Response.JobsDetail.Operation
Output file's media information, not returned when the task is not completed. For details, see MediaInfo.
Container
MediaResult
Response.JobsDetail.Operation
Output file's basic information, not returned when the task is not completed. For details, see MediaResult.
Container
DigitalWatermark
Response.JobsDetail.Operation
Same as Request.Operation.DigitalWatermark in the Request body
Container
UserData
Response.JobsDetail.Operation
Pass through user information
String
JobLevel
Response.JobsDetail.Operation
Task Priority
String
Error Codes
This request returns common error responses and error codes. For more information, see Error Codes.
Practical Example
Request
POST /jobs HTTP/1.1
Authorization: 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.com
Content-Length: 166
Content-Type: application/xml
﻿
<Request>
    <Tag>VideoSynthesis</Tag>
    <Operation>
        <TranscodeTemplateId>t160606b9752148c4absdfaf2f55163b1f</TranscodeTemplateId>
        <WatermarkTemplateId>t146d70eb241c44c63b6efc1cc93ccfc5d</WatermarkTemplateId>
        <VideoSynthesis>
            <KeepAudioTrack>false</KeepAudioTrack>
            <SpliceInfo>
                <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4</Url>
                <Width>640</Width>
            </SpliceInfo>
            <SpliceInfo>
                <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4</Url>
                <X>700</X>
                <Width>640</Width>
                <Height>960</Height>
            </SpliceInfo>
        </VideoSynthesis>
        <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>
Response
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 230
Connection: keep-alive
Date: Mon, 28 Jun 2022 15:23:12 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
﻿
<Response>
    <JobsDetail>
        <Code>Success</Code>
        <Message/>
        <JobId>je8f65004eb8511eaaed4f377124a303c</JobId>
        <State>Submitted</State>
        <Progress>0</Progress>
        <CreationTime>2019-07-07T12:12:12+0800</CreationTime>
        <StartTime>-</StartTime>
        <EndTime>-</EndTime>
        <QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
        <Tag>VideoSynthesis</Tag>
        <Operation>
            <TranscodeTemplateId>t160606b9752148c4absdfaf2f55163b1f</TranscodeTemplateId>
            <WatermarkTemplateId>t146d70eb241c44c63b6efc1cc93ccfc5d</WatermarkTemplateId>
            <VideoSynthesis>
                <KeepAudioTrack>false</KeepAudioTrack>
                <SpliceInfo>
                    <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4</Url>
                    <Width>640</Width>
                </SpliceInfo>
                <SpliceInfo>
                    <Url>https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4</Url>
                    <X>700</X>
                    <Width>640</Width>
                    <Height>960</Height>
                </SpliceInfo>
            </VideoSynthesis>
            <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>
﻿

도움말 및 지원

문제 해결에 도움이 되었나요?

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

tencent cloud

Cloud Object Storage

Submit Tasks

Feature Overview

Authorization Guide

Service Activation

Use Limits

Fee Description

Request

Request Sample

Request Header

Request Body

Response

Response Header

Response Body

Error Codes

Practical Example

Request

Response

도움말 및 지원

Node Name (Keyword)	Parent Node	Description	Type	Required
Request	None	Container for saving requests	Container	Yes

Node Name (Keyword)	Parent Node	Description	Type	Required
Tag	Request	Tag for creating a task: VideoSynthesis	String	Yes
Operation	Request	Operation rule	Container	Yes
CallBackFormat	Request	Task callback format, JSON or XML, default XML, which has a higher priority than the callback format of the queue	String	No
CallBackType	Request	Task callback type, URL or TDMQ, default URL, which has a higher priority than the callback type of the queue	String	No
CallBack	Request	Task callback address, which has a higher priority than the callback address of the queue. When set to "no", the callback address will not trigger a callback.	String	No
CallBackMqConfig	Request	Task callback TDMQ configuration, required when CallBackType is TDMQ. For details, see CallBackMqConfig.	Container	No