智能多媒体 API

  • 图片处理使用说明

    最近更新时间:2017-09-13 09:59:21

    介绍

    七牛云的图片处理服务为七牛云上的图片文件提供以下功能:

    • 对图片进行缩略操作
    • 图片缩放、裁剪、旋转
    • 获取图片格式、大小、色彩模型信息
    • 提供数码相机照片的可交换图像文件格式
    • 图片添加图片、文字、图文混合水印
    • 计算图片的平均色调
    • 注意:
      • 同步处理
        • 同步处理只支持 20MB 以内的图片,超过 20MB 的图片需要使用异步处理
        • 同步处理后的图片wh参数不能超过9999像素,总像素不得超过24999999(2500w-1)像素
        • 同步处理前的图片wh参数不能超过3万像素,总像素不能超过1.5亿像素
      • 异步处理
        • 异步处理无大小限制
        • 异步处理后的图片wh参数不能超过14999像素,总像素不得超过59999999(6000w-1)像素
        • 异步处理前的图片wh参数不能超过3万像素,总像素不能超过1.5亿像素
      • 同步处理和异步处理,处理后图片文件大小没有限制

    接口

    接口 简介
    imageslim 图片瘦身(imageslim)将存储在七牛的JPEG、PNG格式的图片实时压缩而尽可能不影响画质。注意:该功能暂时只支持华东 bucket。
    关于 图片瘦身(imageslim)接口的详细信息请参阅图片瘦身 (imageslim)
    imageView2 图片基本处理接口可对图片进行缩略操作,生成各种缩略图。imageView2 接口可支持处理的原图片格式有 psd、jpeg、png、gif、webp、tiff、bmp。
    关于 imageView2 接口的详细信息请参阅图片基本处理 (imageView2)
    imageMogr2 图片高级处理接口为开发者提供了一系列高级图片处理功能,包括缩放、裁剪、旋转等。imageMogr2 接口可支持处理的原图片格式有 psd、jpeg、png、gif、webp、tiff、bmp。
    关于 imageMogr2 接口的详细信息请参阅图片高级处理 (imageMogr2)
    imageInfo 图片基本信息接口可以获取图片格式、大小、色彩模型信息。在图片下载 URL 后附加 imageInfo 指示符(区分大小写),即可获取 JSON 格式的图片基本信息。
    关于 imageInfo 接口的详细信息请参阅图片基本信息 (imageInfo)
    exif 图片 EXIF 信息接口通过在图片下载 URL 后附加 exif 指示符(区分大小写)获取数码相机照片的可交换图像文件格式。
    关于 exif 接口的详细信息请参阅图片EXIF信息 (exif)
    watermark 七牛云存储提供三种水印接口:图片水印接口、文字水印接口,以及一次请求中同时打多个图文水印接口。
    关于 watermark 接口的详细信息请参阅图片水印处理 (watermark)
    imageAve 图片平均色调接口用于计算一幅图片的平均色调。
    关于 imageAve 接口的详细信息请参阅图片主色调 (imageAve)

    错误响应

    错误响应格式

    如果请求失败,返回包含如下内容的 JSON 字符串 (已格式化,便于阅读):

    {
        "code":     <HttpCode  int>, 
        "error":   "<ErrMsg    string>",
    }
    
    字段名称 必填 说明
    code HTTP状态码,请参考错误码
    error 与HTTP状态码对应的消息文本

    错误码

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

    如遇此错误,请将完整错误信息(包括所有 HTTP 响应头部)通过邮件发送给我们。

    以上内容是否对您有帮助?
  • 提交工单