文档中心

图片处理


图片基本信息

接口

imageInfo

描述

获取图片基本信息包括图片格式、图片大小、图片宽和高、色彩模型、图片帧数,结果采用JSON格式进行返回。

  • 图片格式是计算机存储图片的格式,常见的存储的格式有bmp、jpg、tiff、gif、pcx、tga、exif、fpx、svg、psd、cdr、pcd、dxf、ufo、eps、ai、raw等。

  • 图片大小指图片所占存储空间的大小,单位以B\KB\MB进行表示。超过1024B会转化为KB;超过1024KB会转化为MB。

  • 图片宽和高采用像素作为单位进行表示。

  • 色彩模型也称为色彩模式,是数字世界中表示颜色的一种算法。在数字世界中,为了表示各种颜色,人们通常将颜色划分为若干分量。由于成色原理的不同,决定了显示器、投影仪、扫描仪这类靠色光直接合成颜色的颜色设备和打印机、印刷机这类靠使用颜料的印刷设备在生成颜色方式上的区别。通常有HSB、RGB、Lab和CMYK集中模型。

  • 图片帧数就是指图片是指组成一张GIF图的静态图片数。

权限

该接口操作需要具备GetObject权限,假如获取对象不存在,你可能存在以下两种返回:

  • 假如用户具有该对象所在Bucket的ListBucket权限,会返回状态码404错误
  • 假如用户不具备该对象所在Bucket的ListBucket权限,会返回状态码403错误。

请求

语法
    https://BucketName.kss.ksyun.com/object@base@tag=imageInfo  HTTP/1.1
    Host: BucketName.kss.ksyun.com
请求参数

该请求不需要设置参数。

请求头部

该请求不需要设置特殊的头部。

响应

响应头部
头部名称 必填 说明
Content-Type MIME类型,固定为application/json
响应内容
字段名称 说明
Format 图片格式,如png、jpg、gif、bmp等
Size 图片所占存储空间的大小,单位以B\KB\MB进行表示
Width 图片宽度,单位:像素
Height 图片高度,单位:像素
colorModel 色彩模型,通常有HSB、RGB、Lab和CMYK集中模型
frameNumber 帧数,gif图片会返回此项
特殊错误
HTTP状态码 含义
400 请求报文格式错误
404 资源不存在
403 访问拒绝
500 服务端操作失败。

示例

1、在Web浏览器中输入以下请求:
https://ks3.kss.ksyun.com/image_deal/kssyun.png@base@tag=imageInfo

2、获取返回结果
{
    "colorModel":"TrueColor",
    "format":"JPEG",
    "height":2448,
    "size":"1.8M",
    "width":3264
}