数据万象同步转码-API 文档-文档中心-腾讯云

功能描述
GetSyncConvert 接口用于获取媒体文件同步转码的结果，适用于 Live 实况图与 GIF 图处理以提升其兼容性。
使用说明
此接口为同步模式，异步模式请参考 任务接口-转码任务。
限制说明
支持格式：目前该接口仅支持处理 Gif、Live 图格式的文件。
Gif 动图体积限制：处理图片原图大小不超过40MB，总像素不超过3亿像素。
Live 图体积限制：处理图片原图大小不超过20MB，总时长不超过4秒。
园区限制：当前仅支持重庆园区。
请求示例
1. 通过 GET 请求方式
GET /<ObjectKey>?ci-process=convert&format=mp4 HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
2. 通过 URL 地址添加参数方式
https://<BucketName-APPID>.cos.<Region>.myqcloud.com/for-test.gif?ci-process=convert&format=mp4&<Auth String>
说明：
Authorization: Auth String（详情请参见 请求签名 文档）。
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
﻿
请求参数
参数说明如下：
参数名称
描述
类型
是否必选
ci-process
操作类型，固定使用 convert
String
是
width
转码结果的宽。取值范围：(0,4096]。默认为0
Int
否
height
转码结果的宽。取值范围：(0,4096]。默认为0，当 width 和 height 都为0时，表示使用视频的宽高。如果单个为0，则以另外一个值按视频宽高比例自动适应
Int
否
format
转码的格式，当前仅支持mp4
String
是
请求体
该请求无请求体。
响应
响应头
该响应包含公共响应头，详情请参见 公共响应头部 文档。
响应体
该响应体为转码后文件内容。
错误码
该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。
实际案例
请求1：通过GET请求方式
GET /for-test.gif?ci-process=convert HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2016 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=**************************************-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=****************************************
Content-Length: 0
请求2：通过URL地址添加参数方式
https://examplebucket-1250000000.cos.ap-beijing.myqcloud.com/for-test.gif?ci-process=convert&time=1.5&q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1650425932;1650433132&q-key-time=1650425932;1650433132&q-header-list=&q-url-param-list=&q-signature=*********************************
﻿
响应
HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Length: 266005
Connection: keep-alive
Date: Fri, 10 Mar 2016 09:45:46 GMT
Server: tencent-ci
x-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZmNw==
﻿
﻿
﻿
<视频内容>
﻿

参数名称	描述	类型	是否必选
ci-process	操作类型，固定使用 convert	String	是
width	转码结果的宽。取值范围：(0,4096]。默认为0	Int	否
height	转码结果的宽。取值范围：(0,4096]。默认为0，当 width 和 height 都为0时，表示使用视频的宽高。如果单个为0，则以另外一个值按视频宽高比例自动适应	Int	否
format	转码的格式，当前仅支持mp4	String	是

同步转码

本页目录：

功能描述

使用说明

限制说明

请求示例

1. 通过 GET 请求方式

2. 通过 URL 地址添加参数方式

请求头

请求参数

请求体

响应

响应头

响应体

错误码

实际案例

请求1：通过GET请求方式

请求2：通过URL地址添加参数方式

响应