智能多媒体 API

  • 动图合成

    最近更新时间:2018-12-05 00:16:03

    接口简介

    动图合成接口(animate)用于将多张图片合成 GIF 动图。
    注:

    • 动图合成接口目前仅适用于存储在七牛的图片。
    • 接口可支持处理的原图片格式有 jpeg 和 png。
    • 支持的最大帧数为 20。
    • 支持的最大图片尺寸为 1080*1080

    接口规格

    animate/duration/<duration>
           /merge/key/<encodedImageKey>
                 /key/<encodedImageKey>
                 ...
           /effect/<effectType>
    

    请求参数详解

    名称 必填 说明
    <duration> Y GIF动图的每帧间隔时间。单位:牛秒(nws),即0.1s。取值要求为大于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元/千次。

    以上内容是否对您有帮助?
  • Icon free helper
    Close