智能多媒体 >
API 文档 >
图片处理 >
动图合成（animate）
动图合成（animate）
最近更新时间：2019-08-26 18:46:39
接口简介
动图合成接口（animate）用于将多张图片合成 GIF 动图。
注：
- 动图合成接口目前仅适用于存储在七牛的图片。
- 接口可支持处理的原图片格式有 jpeg 和 png。
- 支持的最大帧数为 20。
- 支持的最大图片尺寸为 1080*1080
接口规格
animate/duration/<duration>
/merge/key/<encodedImageKey>
/key/<encodedImageKey>
...
/effect/<effectType>
请求参数详解
| 名称 |
必填 |
说明 |
<duration> |
Y |
GIF动图的每帧间隔时间(单位: 0.01s)，取值要求为大于0的整数。 |
<encodedImageKey> |
N |
合成GIF动图的源图片key(经过Base64编码)，保证所有的源图都来源于同一个bucket。 |
<effectType> |
N |
定义播放顺序，取值：0，1。（0:正序循环播放；1:倒序循环播放；）默认为0。 |
请求报文
GET <imageDownloadURI>?<接口规格> HTTP/1.1
Host: <imageDownloadHost>
头部信息
| 头部名称 |
必填 |
说明 |
| Host |
是 |
下载服务器域名，可为七牛三级域名或自定义二级域名，参考七牛自定义域名绑定流程。 |
响应报文
HTTP/1.1 200 OK
Content-Type: <imageMimeType>
<imageBinaryData>
头部信息
| 头部名称 |
必填 |
说明 |
| Content-Type |
是 |
MIME类型，成功时为图片的MIME类型，失败时为application/json。 |
| Cache-Control |
否 |
缓存控制，失败时为no-store，不缓存。 |
响应内容
- 如果请求成功，返回图片的二进制数据。
- 如果请求失败，返回包含如下内容的 JSON 字符串（已格式化，便于阅读）：
{
"code": <HttpCode int>,
"error": "<ErrMsg string>",
}
| 字段名称 |
说明 |
| code |
HTTP状态码，请参考响应状态码。 |
| error |
与HTTP状态码对应的消息文本。 |
响应状态码
| HTTP状态码 |
含义 |
| 200 |
生成GIF成功。 |
| 400 |
请求报文格式错误。 |
| 404 |
资源不存在。 |
| 500 |
服务端操作失败。如遇此错误，请请将完整错误信息（包括所有的HTTP响应头部）提交工单 给我们。 |
服务价格
计费方式：按调用次数计费。
价格：0.2元/千次。
售前 
售后 