使用说明
介绍
七牛云的图片处理服务为七牛云上的图片文件提供以下功能:
- 对图片进行缩略操作
- 图片缩放、裁剪、旋转
- 获取图片格式、大小、色彩模型信息
- 提供数码相机照片的可交换图像文件格式
- 图片添加图片、文字、图文混合水印
- 计算图片的平均色调
- 注意:
- 同步处理 :
- 同步处理只支持 20MB 以内的图片,超过 20MB 的图片需要使用异步处理
- 同步处理后的图片
w
和h
参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素 - 同步处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素
- 异步处理 :
- 异步处理无大小限制 (imageInfo 目前异步不支持文件大小大于20M的图片)
- 异步处理后的图片
w
和h
参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素 - 异步处理前的图片
w
和h
参数不能超过3万像素,总像素不能超过1.5亿像素
- 同步处理和异步处理,处理后图片文件大小没有限制
- 同步处理 :
接口
接口 | 简介 |
---|---|
图片基本处理 | 图片基本处理接口可对图片进行缩略操作,生成各种缩略图。imageView2 接口可支持处理的原图片格式有 psd、jpeg、png、gif、webp、tiff、bmp。 关于 imageView2 接口的详细信息请参阅图片基本处理 (imageView2)。 |
图片高级处理 | 图片高级处理接口为开发者提供了一系列高级图片处理功能,包括缩放、裁剪、旋转等。imageMogr2 接口可支持处理的原图片格式有 psd、jpeg、png、gif、webp、tiff、bmp。 关于 imageMogr2 接口的详细信息请参阅图片高级处理 (imageMogr2)。 |
图片瘦身 | 图片瘦身接口将存储在七牛的JPEG、PNG格式的图片实时压缩而尽可能不影响画质。 关于 图片瘦身(imageslim)接口的详细信息请参阅图片瘦身 (imageslim)。 |
图片基本信息 | 图片基本信息接口可以获取图片格式、大小、色彩模型信息。在图片下载 URL 后附加 imageInfo 指示符(区分大小写),即可获取 JSON 格式的图片基本信息。 关于 imageInfo 接口的详细信息请参阅图片基本信息 (imageInfo)。 |
图片水印处理 | 提供四种水印接口:图片水印、文字水印,文字平铺水印、混合水印。 关于 watermark 接口的详细信息请参阅图片水印处理 (watermark)。 |
盲水印处理 | 为原图添加不可见水印,不影响原图质量。 关于图片盲水印接口的详细信息请参阅图片盲水印处理 (watermark)。 |
图片EXIF信息 | 图片 EXIF 信息接口通过在图片下载 URL 后附加 exif 指示符(区分大小写)获取数码相机照片的可交换图像文件格式。 关于 exif 接口的详细信息请参阅图片EXIF信息 (exif)。 |
图片圆角处理 | 图片圆角处理接口将图片生成圆角图片,并且可以指定图片的圆角大小。 关于图片圆角处理接口的详细信息请参阅图片圆角处理 (roundPic)。 |
图片平均色调 | 图片平均色调接口用于计算一幅图片的平均色调。 关于 imageAve 接口的详细信息请参阅图片主色调 (imageAve)。 |
动图合成 | 动图合成接口用于将数张图片合成 GIF。 关于 animate 接口的详细信息请参阅动图合成 (animate)。 |
错误响应
错误响应格式
如果请求失败,返回包含如下内容的 JSON 字符串 (已格式化,便于阅读):
{
"code": <HttpCode int>,
"error": "<ErrMsg string>",
}
字段名称 | 必填 | 说明 |
---|---|---|
code | 是 | HTTP状态码,请参考 错误码。 |
error | 是 | 与HTTP状态码对应的消息文本 |
错误码
HTTP状态码 | 含义 |
---|---|
400 | 请求报文格式错误 |
404 | 资源不存在 |
599 | 服务端操作失败 如遇此错误,请将完整错误信息(包括所有 HTTP 响应头部)提交工单 给我们。 |
文档反馈
(如有产品使用问题,请提交工单)