智能多媒体 API

  • 图片平均色调

    最近更新时间:2018-01-22 19:54:28

    imageAve接口用于计算一幅图片的平均色调,并以0xRRGGBB形式返回。

    注意:

    • 请求图片长和宽均不能超过10000像素
    • 请求图片总大小不超过20MB

    请求报文

    请求语法

    GET <imageDownloadUri>?imageAve HTTP/1.1
    Host: <imageDownloadHost>
    

    头部信息

    头部名称 必填 说明
    Host 下载服务器域名,可为七牛三级域名或自定义二级域名,参考七牛自定义域名绑定流程

    响应报文

    响应语法

    HTTP/1.1 200 OK
    Content-Type: application/json
    Cache-Control: no-store
    
    {
        "RGB": "<ImageAve string>"
    }
    

    头部信息

    头部名称 必填 说明
    Content-Type MIME类型,固定为application/json
    Cache-Control 缓存控制,固定为no-store,不缓存。

    响应内容

    • 如果请求成功,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "RGB": "<ImageAve string>"
    }
    
    字段名称 必填 说明
    RGB 图片主色调,0xRRGGBB格式。
    • 如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
    {
        "code":     <HttpCode  int>, 
        "error":   "<ErrMsg    string>",
    }
    
    字段名称 必填 说明
    code HTTP状态码,请参考响应状态
    error 与HTTP状态码对应的消息文本

    响应状态码

    HTTP状态码 含义
    200 请求成功
    400 请求报文格式错误
    404 资源不存在
    599 服务端操作失败。

    如遇此错误,请将完整错误信息(包括所有HTTP响应头部)提交工单 给我们。

    注意:缩略图等经过云处理的新图片不支持该方法。

    示例

    在Web浏览器中输入以下图片地址:

    https://o6nalx2hr.qnssl.com/0.jpg?imageAve
    

    返回结果(内容经过格式化以便阅读):

    {
        "RGB": "0x85694d"
    }
    
    以上内容是否对您有帮助?
  • Close