URL格式

http://imgx.sinacloud.net/<bucket>/<处理指令>/<文件路径>?<querystring>

或者

http://<bucket>.imgx.sinacloud.net/<处理指令>/<文件路径>?<querystring>

• bucket : 您在新浪云存储(SCS)中创建的bucket名称；
• 处理指令 : 对原始图片的处理指令，下面有详细介绍；
• 文件路径 : 原始图片文件在SCS中的存储路径；
• querystring : 主要是签名相关的参数；

举例

例如：原始图片在云存储中的url为：http://sinacloud.net/yun/demo/1.jpg 可以看出：

• bucket为：yun
• object为：demo/1.jpg

下面我们进行下列操作：

• 裁剪人脸区域, 并将图片缩略：400x400：c_thumb,g_face,w_400,h_400
• 将图片变成圆角，半径为最大(正圆)：r_max
• 将图片亮度增加8%：e_brightness:8
• 将图片格式转换为png格式：f_png

处理指令为：c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png 我们可以通过URL直接进行访问：

http://imgx.sinacloud.net/yun/c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png/demo/1.jpg

或者

http://yun.imgx.sinacloud.net/c_thumb,g_face,w_400,h_400,r_max,e_brightness:8,f_png/demo/1.jpg

或者创建一个json文件(如果您不想将处理指令暴露在URL中)，内容为：

[
    {  
        "crop" : "thumb",
        "gravity" : "face",
        "width" : 400,
        "height" : 400,
        "radius" : "max",
        "effect" : "brightness:8",
        "format" : "png"
    }
]

将文件保存到您对应的bucket下的路径：

imgx/t/my_thumb.json    #其中文件名(my_thumb)是您自定义的“指令集名称”，类似css中的class

然后就可以通过下面的URL进行访问（也就是说，处理指令也可以不用放在URL中，直接隐藏到您自定义的json文件中）：

http://imgx.sinacloud.net/yun/t_my_thumb/demo/1.jpg

指令格式

• 指令名和指令值之间用”_“连接 c_fit
• 相关指令使用逗号隔开“,” c_fit,w_100,h_100,g_face
• 多组指令之间用“--”隔开 c_fit,w_100,h_100,g_face,r_max--l_text:my_font:hello+word,w_100,h_40

签名 & 认证

• 建议您使用URL签名，目的在于您的图片处理指令不会被别人滥用而耗费您的流量，并且可以保护原图不被盗取。
• 注意：签名算法兼容SCS《签名算法》，<处理指令>/<文件路径>作为object参与签名
• 如果您不想使用签名，需要对您的bucket设置一条ACL，对SINA000000000000IMGX开放读写权限，可以通过调用API设置，也可以使用控制台设置ACL，如下图：
• 如果您不想使用签名，不需要开放匿名权限的ACL，只需要开放SINA000000000000IMGX的权限；
• 签名算法参见：《签名算法》

缓存 & CDN

• 处理后的图片生成缓存，下次请求不在重复生成，默认缓存7天
• 处理后的图片会自动推送到CDN节点
• 如果您的原图修改了，可以使用v指令重新生成图片，后面详细介绍

图片处理指令

水印功能详细介绍

1. 水印分为：图片水印 和 文字水印；
2. 如果您使用了水印 l 指令，则和 l 一组的其他指令将针对 水印图片或者文字 进行处理（如：w、h、g、x、y、o、bo、e、a、r等），后面举例介绍。

图片水印

您需要预先将水印贴图保存到对应的bucket下 imgx/l/<filename>.png，图片必须是png格式，下面两张图为例：

下面举例介绍具体功能

文字水印

您需要预先将文字水印的字体配置(json格式的文件)保存到对应的bucket下 imgx/l/<file>.json，例如：

{
    "font_family" : "Xingkai SC",
    "font_style" : "bold",
    "font_size" : 30,
    "font_color" : "000000",
    "background" : "ff0000cc",
    "padding" : 10,
    "word_spacing" : 1,
    "kerning" : 1,
    "line_spacing" : 2,
    "pierced" : false,
    "tile" : false,
    "text" : "默认值",
}

对应路径：imgx/l/my_font.json

字体参数介绍

所有参数非必填项

示例1：

imgx/l/simple_font.json :

{
    "font_family" : "Microsoft YaHei",
    "font_size" : 40,
    "font_color" : "ffffff"
}

一个最简单的文字水印

指令：

w_800,f_png--l_text:simple_font:Hello+SCS!!,x_20,y_20,a_-25

示例2：

imgx/l/subtitles.json :

{
    "font_size" : 22,
    "font_color" : "ffffff"
}

imgx/l/subtitles_s.json :

{
    "font_size" : 16,
    "font_color" : "ffffff"
}

咱们也搞一个大片效果, 应用到两张图上：

指令：

f_png,c_fill,w_800,h_400,e_brightness:-8--c_pad,w_800,h_550,g_center,b_000000ff,e_yellow:30--l_text:subtitles:%E4%B8%BA%E5%BC%80%E5%8F%91%E8%80%85%E6%8F%90%E4%BE%9B%E4%B8%80%E5%A5%97%E4%BA%91%E7%AB%AF%E5%9B%BE%E7%89%87%E5%A4%84%E7%90%86%E6%9C%8D%E5%8A%A1,g_south,y_100--l_text:subtitles_s:SinaImgx%20is%20the%20image%20back-end%20for%20web%20and%20mobile%20developers,g_south,y_80

示例3：

imgx/l/my_font.json :

{
    "font_family" : "Xingkai SC",
    "font_style" : "bold",
    "font_size" : 40,
    "font_color" : "000000",
    "background" : "ff0000cc",
    "padding" : 18
}

过年了，咱们做一个对联：

指令：

w_800,f_png--l_text:my_font:%E9%A9%AC%E9%A9%B0%E5%A4%A7%E9%81%93%E5%BE%81%E9%80%94%E8%BF%9C,g_south_west,w_40,x_20,y_40--l_text:my_font:%E7%BE%8A%E4%B8%8A%E5%A5%87%E5%B3%B0%E6%99%AF%E8%89%B2%E5%A8%87,g_south_east,w_40,x_20,y_40--l_text:my_font:%E6%96%B0%E6%B5%AA%E4%BA%91%E5%AD%98%E5%82%A8,g_north,y_20

示例4：

imgx/l/font_me.json :

{
    "font_family": "Microsoft YaHei",
    "font_size": 60,
    "font_color": "ffffff",
    "font_style": "bold",
    "background": "0000008f",
    "pierced": true,
    "tile": false,
    "padding": 24,
    "word_spacing": 2.2,
    "line_spacing": 1.2,
    "kerning": 1.5
}

镂空字效果

指令：

l_text:font_me:%E4%BD%A0%E5%A5%BD%EF%BC%8C%E4%BA%91%E5%AD%98%E5%82%A8,g_west,x_50,y_-200--w_800

示例5：

imgx/l/tile.json :

{
    "font_family" : "Microsoft YaHei",
    "font_style" : "bold",
    "font_size" : 40,
    "font_color" : "000000",
    "background" : "ff000066",
    "padding" : 18,
    "tile": true
}

平铺效果

指令：

w_800,f_png--l_text:tile:Hello+SCS!!,g_south

示例6：

imgx/l/badge.json :

{
    "font_style" : "bold",
    "font_size" : 30,
    "font_color" : "ffffff",
    "background" : "ff0000cc",
    "padding" : 15
}

增加一个badge(数字徽章)

指令：

c_thumb,g_face,w_200,h_200,r_max,bo_6_ffffff80,f_png--l_text:badge:69,r_max,g_south_east,w_34,h_34,x_-1,y_-5

使用“指令集”

如果您不希望把指令暴露在URL中，很简单：

下面举例说明，自动识别照片上的人脸位置并做一张带有边框的圆形缩略图：

• 先创建一个json文件，保存到对应的bucket中： 路径： imgx/t/avatar.json ：

[
    {
        "crop" : "thumb",
        "gravity" : "face:center",
        "width" : 200,
        "height" : 200,
        "radius" : "max",
        "border" : "6_ffffff80",
        "format" : "png"
    },
    {
        "overlay" : "icon_v",
        "gravity" : "south_east",
        "width" : 60,
        "x" : -1,
        "y" : -5
    }
]

• 通过下面的方式访问：

http://imgx.sinacloud.net/yun/t_avatar/demo/1.jpg
http://imgx.sinacloud.net/yun/t_avatar/demo/3.png

• 效果：

字体 (font_family)

• STZhongsong
• Heiti SC
• Yuppy SC
• Hannotate TC
• SimHei
• Lucida Console
• STHupo
• Wawati SC
• Candara
• Meiryo
• STKaiti
• Kaiti TC
• Bookshelf Symbol 7
• MS PGothic
• Candelita
• MS Reference Specialty
• Marlett
• SimSun-ExtB
• Baoli SC
• Adobe Kaiti Std
• Adobe Fangsong Std
• STHeiti
• MS Reference Sans Serif
• Gulim
• Xingkai SC
• STXingkai
• Libian SC
• MJNgai PRC
• STLiti
• Batang
• Franklin Gothic Medium
• Heiti TC
• PMingLiU
• Lantinghei SC
• MS PMincho
• Yuanti SC
• HanziPen TC
• STFangsong
• SimSun
• Lantinghei TC
• MS Gothic
• Weibei SC
• Kaiti SC
• Cambria
• Consolas
• Adobe Heiti Std
• Constantia
• Brush Script MT
• Hannotate SC
• HanziPen SC
• Hiragino Sans GB
• KaiTi
• Perpetua
• MS Mincho
• Lucida Sans Unicode
• Tw Cen MT
• Gill Sans MT
• STXinwei
• Songti SC
• SentyPaperCut
• Villasukat
• Calibri
• Franklin Gothic Book
• FangSong
• Songti TC
• Adobe Song Std
• Microsoft YaHei
• Corbel
• STSong