智能多媒体服务

    • 智能多媒体 > API 文档 > 图片处理 >图片基本信息（imageInfo）

    图片基本信息（imageInfo）

    最近更新时间：2019-08-26 18:46:07

    图片基本信息包括图片格式、图片大小、色彩模型。
    在图片下载URL后附加imageInfo指示符（区分大小写），即可获取JSON格式的图片基本信息。

    请求报文

    请求语法

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

    头部信息

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

    响应报文

    响应语法

    HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

{
    "size":         "<ImageSize         int>",
    "format":       "<ImageType         string>",
    "width":         <ImageWidth        int>,
    "height":        <ImageHeight       int>,
    "colorModel":   "<ImageColorModel   string>",
    "frameNumber":   <ImageFrameNumber  int>
}

    头部信息

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

    响应内容

    • 如果请求成功，返回包含如右内容的JSON字符串（已格式化，便于阅读）： 
    {
    "size":         "<ImageSize         int>",
    "format":       "<ImageType         string>",
    "width":         <ImageWidth        int>,
    "height":        <ImageHeight       int>,
    "colorModel":   "<ImageColorModel   string>",
    "frameNumber":   <ImageFrameNumber  int>
}
    字段名称 必填 说明
    size 是 文件大小，单位：Bytes
    format 是 图片类型，如png、jpeg、gif、bmp等。
    width 是 图片宽度，单位：像素(px)。
    height 是 图片高度，单位：像素(px)。
    colorModel 是 彩色空间，如palette16、ycbcr等。
    frameNumber 帧数，gif 图片会返回此项。
    • 如果请求失败，返回包含如右内容的JSON字符串（已格式化，便于阅读）： 
    {
    "code":     <HttpCode  int>, 
    "error":   "<ErrMsg    string>",
}
    字段名称 必填 说明
    code 是 HTTP状态码，请参考响应状态码。
    error 是 与HTTP状态码对应的消息文本

    响应状态码

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

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

    示例

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

    http://dn-odum9helk.qbox.me/resource/gogopher.jpg?imageInfo

    返回结果（内容经过格式化以便阅读）：

    {
size: 214513,
format: "jpeg",
width: 640,
height: 427,
colorModel: "ycbcr",
orientation: "Top-left"
}
    以上内容是否对您有帮助？
    • Qvm free helper
    Close