tencent cloud

数据万象

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
功能概览
地域与域名
使用限制
产品计费
计费概述
计费方式
计费项
免费额度
欠费说明
查看消费明细
常见问题
快速入门
注册与登录
绑定存储桶
上传和处理文件
下载和删除文件
解绑存储桶
通过 COS 使用数据万象
能力地图
图片处理
媒体处理
内容审核
AI 内容识别
文档处理
智能语音
文件处理
用户指南
概览
存储桶管理
智能工具箱
任务与工作流
数据监控
用量统计
实践教程
版权保护解决方案
图片处理实践
API 授权策略使用指引
工作流实践
API 文档
API 概览
结构体
公共请求头部
公共响应头部
开通万象服务
图片处理
AI 内容识别
智能语音
媒体处理
内容审核
文档处理
文件处理
任务与工作流
云查毒
错误码
请求签名
SDK 文档
SDK 概览
图片处理 Android SDK
图片处理 iOS SDK
COS Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Go SDK
COS iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
小程序 SDK
SDK 产品个人信息保护规则
安全与合规
权限管理
常见问题
基础设置
文档处理
媒体处理
内容识别
智能语音
服务协议
Service Level Agreement
联系我们
词汇表
文档数据万象API 文档图片处理合成动图

合成动图

PDF
聚焦模式
字号
最后更新时间： 2025-12-24 17:40:35

功能概述

腾讯云数据万象通过 imageMogr2接口提供合成功能，可将多张 jpg 或 png 格式的图片合成为一个 GIF 动图。该功能支持以下处理方式：
下载时处理
上传时处理
云上数据处理

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加对应的权限。对象存储支持的所有操作接口请参见 COS action。
下载时处理：授权策略中 action 设置为 cos:GetObject。
上传时处理：授权策略中 action 设置为 cos:PutObject。
云上数据处理：授权策略中 action 设置为 cos:PutObject。
说明：
GetObject 对应的 resource 为源文件，PutObject 对应的 resource 为转存的文件。

服务开通

首次使用该功能时将默认为您开通数据万象，同时该存储桶将自动绑定数据万象，无需角色授权，即可直接使用。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
动图合成接口目前仅适用于存储在 COS 上的图片。
支持合成的原图格式：jpg/jpeg、png。
支持的最大帧数：20。
原图限制：大小不超过32MB，图片尺寸不超过1080*1080。

费用说明

该接口为付费服务，产生的费用将由数据万象收取，详细计费说明可参见 图片处理费用。
如果采用下载时处理的方式，且通过外网进行下载，调用会产生 流量费用。
该功能计入基础图片处理用量，其中处理用量按原图大小之和计算，例如使用了10张大小为5MB的 jpg 图片进行合成动图，则统计用量计为50MB。

接口示例

下载时处理

GET /<ObjectKey>?imageMogr2/animate/duration/<duration>/images/<imageurl1>/<imageurl2> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
说明：
请忽略上面的空格与换行符。

上传时处理

PUT /<ObjectKey> HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Pic-Operations: 
{
  "is_pic_info": 1,
  "rules": [{
      "fileid": "exampleobject",
      "rule": "imageMogr2/animate/duration/<duration>/images/<imageurl1>/<imageurl2>"
  }]
}

云上数据处理

POST /<ObjectKey>?image_process HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Content-length: Size
Authorization: Auth String
Pic-Operations: 
{
  "is_pic_info": 1,
  "rules": [{
      "fileid": "exampleobject",
      "rule": "imageMogr2/animate/duration/<duration>/images/<imageurl1>/<imageurl2>"
  }]
}
说明：
Authorization: 携带鉴权信息，用于验证请求的合法性的请求头，Pic-Operations 头部需签入签名信息中，详情请参见 请求签名 文档。
Pic-Operations 为 json 格式的字符串，具体参数信息请参见 图片持久化处理。
当 fileid 与 ObjectKey 相同时，处理后的图片将覆盖原图存储；不相同时将分别存储原图和处理后图片。
fileid 的值需要经过 URLEncode。

处理参数说明

参数
参数说明
类型
是否必填
ObjectKey
COS 中的文件名称，例如 folder/sample.jpg，在这里将作为合成后的动图第一帧。
String
是
duration
GIF 动图的每帧间隔时间(单位: ms)，取值为大于0的整数。例如设置间隔为10ms，则参数为/duration/10。
Int
是
images
待合成的图片原图链接，最多可添加19个，需要经过 URL安全 Base64编码。例如原图1的链接经过编码后的字符串为 ahxxxxxxxxxmc，原图2的链接经过编码后的字符串为wywxxxxxxxxjih，则参数为 /images/ahxxxxxxxxxmc/wywxxxxxxxxjih。
String
是
注意：
如果待合成的原图尺寸不相同，最终合成的动图将以第一帧的体积为标准，对所有图片进行等比缩放。

实际案例

说明：
本篇文档中的实际案例仅包含下载时处理，该类处理不会保存处理后的图片至存储桶。如有保存需求，请参见 图片持久化处理 文档并配置上传时处理或云上数据处理。
以存储桶 examples-125xxxxxx 中的 image-1.jpg 为动图首帧，和同个存储桶内的 image-2.jpg 合成为一个间隔50ms的动图。
http://examples-125xxxxxx.cos.ap-shanghai.myqcloud.com/image-1.jpg?imageMogr2/animate/duration/50/images/aHR0cDovL2V4YW1wbGVzLTEyNXh4eHh4eC5jb3MuYXAtc2hhbmdoYWkubXlxY2xvdWQuY29tL2ltYWdlLTIuanBn

注意事项

为了避免未授权人员通过访问不携带处理参数的链接实现访问和下载原图的情况，您可同时将处理参数签入到请求签名中，处理参数整体是参数的 key，value 为空，如下是简单的示例（仅做样式参考，可能已经过期无法直接访问），详细计算方法请参见 请求签名。
http://examples-1251000004.cos.ap-shanghai.myqcloud.com/sample.jpeg?q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1593342360;1593342720&q-key-time=1593342360;1593342720&q-header-list=&q-url-param-list=watermark%252f1%252fimage%252fahr0cdovl2v4yw1wbgvzlteyntewmdawmdqucgljc2gubxlxy2xvdwquy29tl3nodwl5aw4uanbn%252fgravity%252fsoutheast&q-signature=****************************************&watermark/1/image/aHR0cDovL2V4YW1wbGVzLTEyNTEwMDAwMDQucGljc2gubXlxY2xvdWQuY29tL3NodWl5aW4uanBn/gravity/southeast
上一篇: 盲水印下一篇: 获取原图

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈