Object（对象、文件）

在IMG中，用户操作图片的基本数据单元是Object。即OSS对应的Object，单个Object（即每张图片）允许的最大大小是20MB。

Object 命名规范：

• 使用 UTF-8 编码。
• 长度必须在 1-1023 字节之间。
• 不能以“/”或者“\”字符开头。

Channel （频道）

Channel 是IMG上的命名空间，也是计费、权限控制、日志记录等高级功能的管理实体。IMG名称在整个图片处理服务中具有全局唯一性，且不能修改。一个用户最多可创建10个Channel，但每个Channel中存放的object的数量没有限制。目前Channel跟OSS的Bucket相对应，即用户只能创建与自己在OSS上Bucket同名的Channel。

Channel命名规范：

• 只能包括小写字母，数字，短横线(-)。
• 必须以小写字母或者数字开头和结尾。
• 长度必须在 3-63 字节之间。

Style（样式）

图片处理服务提供用户将图片的处理操作和参数保存成一个别名，即样式。一系列操作，利用样式功能后，只需要用一个很短的URL就能实现相同的效果。

• 一个Channel下面有多个样式，目前一个Channel允许最多有50个样式。
• 样式适应于Channel下面的object图像变化操作。假如在A Channel下面有样式，名称为abc， 样式内容是100w.jpg（按宽缩略成100，保存成jpg格式），那么A Channel下面所有的object都能使用样式abc，实现缩略成 100w.jpg的效果。
• 样式的作用范围只在一个Channel下，即A Channel不能使用B Channel的样式。

Style命名规范：

• 长度为1-63个字符。
• 只能包含数字、大小写字母、下划线（_）、短横线（-）以及小数点（.）。

处理字符串

图片服务定义了处理字符串，包含转换参数、转换格式两个部分：

• 转换参数由一个或多个键值对（以”_”连接）组成，“值”在前“键”在后，“值”为数字类型，“键”为一位字母。
• 转换格式是一种特殊的转换参数，用户指定转换格式，图片服务对原图处理并返回用户期望的图片文件格式。（支持转换的原图格式是：jpg、jpeg、webp、png、bmp）。

分隔符

图片处理服务通过URL来访问处理的图片。 所以需要分隔符来区分一些关键字段。不要在使用的图片文件名称中包含图片处理服务设定的分隔符。不然会导致解析出错的问题。

分隔符名称	分隔符	含义
处理分隔符	@	区分Object名称跟处理字符串。
样式分隔符	@！	区分Object跟样式内容，详见样式访问。
管道分隔符	|	区分多种操作，详见管道。

数据中心及访问域名

图片服务的数据中心和OSS的数据中心相对应。用户在OSS的某个数据中心上创建一个Bucket，然后选择开通图片服务，那么对应的Channel也属于该数据中心。开通的数据中心及域名见访问域名。

示例

下面以一个例子来说明上面提到的概念。

http://image-demo.img-cn-hangzhou.aliyuncs.com/example.jpg@100w_100h.jpg

这是一个图片访问的URL，其中各参数说明如下：

• image-demo：用户的频道的名字，即Channel
• img-cn-hangzhou.aliyuncs.com：图片杭州地区访问域名，即Endpoint
• example.jpg：待处理的图片的原图名字，即Object
• @：处理分隔符
• 100w_100h.jpg：处理字符串
• 100w_100h：将原图进行处理的参数，即转换参数
• .jpg：将原图根据参数处理后的保持的格式，即转换格式

限制

• 图片处理支持的格式有：jpg、png、bmp、gif、webp、tiff。
• 指定缩略图宽度或者高度时，在等比缩放的情况下，都会默认进行单边的缩放。在固定宽高的模式下，会默认在宽高一样的情况下进行缩放。
• 对缩略后的图片大小有限制，目标缩略图的宽与高的乘积不能超过4096 * 4096， 且单边的长度不能超过4096 * 4。
• 调用resize，默认不允许放大。如果请求图片比原图大，那么返回的仍然是原图。如果想得到放大的图片，需要增加参数调用limit,0。
• 管道目前限制在4个。

其他限制可以参考文档其他参数的详细描述。