智能多媒体 API

  • 图片圆角处理

    最近更新时间:2018-01-18 18:21:00

    roundPic 将图片生成圆角图片,并且可以指定图片的圆角大小。这个接口支持的原图片格式有pngjpg,处理后的图片格式为png

    注意:处理前的图片大小不能超过20M。

    接口规格

    注意:接口规格不含任何空格与换行符。

    roundPic/radius/<radius>
            /radiusx/<radiusx>
            /radiusy/<radiusy>
    
    参数名称 必填 说明
    /radius/<radius> 圆角大小的参数,水平和垂直的值相同,可以使用像素数(如200)或百分比(如!25p)。不能与radiusxradiusy同时使用。
    /radiusx/<radiusx> 圆角水平大小的参数,可以使用像素数(如200)或百分比(如!25p)。需要与radiusy同时使用。
    /radiusy/<radiusy> 圆角垂直大小的参数,可以使用像素数(如200)或百分比(如!25p)。需要与radiusx同时使用。

    注意:

    1.其中当像素数大于宽(高)的1/2时取其1/2,百分比大于!50p时,取!50p;

    2.像素数与百分比均需为非负值,命令roundPic/radius/!50p可使方形图片变圆。

    请求报文

    请求语法

    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字符串(已格式化,便于阅读):

    {
      "error": "invalid roundPic command"
    }
    
    字段名称 必填 说明
    code HTTP状态码,请参考响应状态码
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 缩略成功
    400 请求报文格式错误
    404 资源不存在
    599 服务端操作失败。
    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。

    示例

    • 把一张图片变成圆角:
    http://odum9helk.qnssl.com/resource/gogopher.jpg?roundPic/radius/50
    

    查看效果图

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