智能多媒体 >
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元/千次。