API 文档

常见问题

最近更新时间:2020-08-07 18:00:21

数据万象有哪些图片处理功能?

数据万象拥有缩放、裁剪、转码、水印、内容审核等图片处理功能,满足您的多种业务需求。

数据万象可以处理哪些格式的图片?

数据万象目前支持处理 JPG、BMP、GIF、PNG、WEBP 格式,并且支持 HEIF 格式的解码和处理操作。

数据万象图片处理的限制是?

处理图片原图大小不超过20MB、宽高不超过30000像素且总像素不超过1亿像素,处理结果图宽高设置不超过9999像素;针对动图,原图宽 x 高 x 帧数不超过1亿像素。

数据万象的数据存储在哪里?

数据万象的数据存放在腾讯云对象存储上。您可以在上传时进行图片处理,将处理结果持久化保存,或者在下载时进行图片处理。

存量图片如何迁移至腾讯云?

使用 COS 迁移工具 COS Migration Tool 或者使用 MSP 产品进行迁移即可。

说明:

迁移时,需要您提供源站 Bucket 名称及相应 List 权限

如何在不影响现网图片使用的情况下切换至腾讯云数据万象的服务?

使用 COS 的镜像回源功能,将 COS Bucket 与源站绑定,之后将图片处理域名切换为万象域名即可(数据万象将回源至源站拉取原图并进行处理,同时 COS 将异步拉取图片)。该方法可实现图片迁移,但只能触发所请求资源的迁移。

CDN 域名是否支持图片处理?

数据万象支持通过 CDN 域名进行图片处理。用户只需在数据万象控制台开启 CDN 加速,或通过 CDN 控制台将加速域名的源站设置为数据万象的域名(使用自有源将万象域名填入)即可。

能否在一次请求中实现多种处理?

可以。只需使用样式分隔符即可实现。例如 url?imageMorg2/cut/400x400|watermark/1/xxx 能够同时对图片实现裁剪和添加水印。

图片处理如何收费?

图片基础处理服务(例如裁剪、缩放、转码、水印等功能)按照0.025元/GB收费。增值服务,例如内容识别、盲水印、Guetzli 等功能需额外收费。费用详情请参见 计费与定价

处理后的图片是否会被存储下来?

直接通过 API 接口,在下载时进行的图片处理不会被存储在客户的存储空间中。

图片处理能否在上传或下载时进行?

图片上传、下载时均可进行图片处理,且用户可对已存放在 COS 上的现有数据进行图片处理。

图片处理的链接是否支持加密访问?

支持。您可以对照我们配置相应的编解码规则,将访问链接进行加密处理。加密访问是定制化规则,如果有需求请 提交工单 进行申请。

如何对图片同时做多种处理操作?

以同时做裁剪+水印为例,使用 “l” 管道操作符将处理参数连接,可达到顺序处理的效果。

微信小程序的多处理规则无效应该怎么办?

以使用管道操作符 “|” 无效为例,管道操作符 “|” 在微信小程序中会被转义或截断,则需要对该操作符做重新定义。
解决方案如下:

  • 使用样式。
  • 把操作符 “|” 替换成 “%7C”。

为什么无论加什么参数,图片质量、大小都未改变?

原因可能是原图 EXIF 信息过多,占了大部分图片容量,一次调整图片分辨率后,图片大小没有太大的变化。可使用 Strip参数,过滤 EXIF 信息。具体使用方法请参照 去除元信息

水印图未生效的原因有哪些?

水印图未生效的常见原因有如下几点:

  • 水印图与需要添加水印的原图不在同一 Bucket。
  • 水印图的 URL 链接格式错误。(例如,URL 必须以http://开始,不能省略开头的 HTTP,也不能填成 HTTPS)
  • 水印图的 URL 必须使用万象优图源站的域名,不可使用 CDN 加速域名等其他域名。

CI 防盗链配置是否可以同步至 COS?

防盗链配置与域名绑定,因 CI 与 COS 域名不同,所以防盗链配置相互独立。

什么是 URL 安全的 BASE64 编码?

在数据万象的处理操作中,有很多参数需要进行 URL 安全的 BASE64 编码,例如文字水印的文字内容、颜色、字体设置和图片水印的水印图链接。URL 安全的 BASE64 编码具体规则为:

  1. 将普通 BASE64 编码结果中的加号(+)替换成连接号(-);
  2. 将编码结果中的正斜线(/)替换成下划线(_);
  3. 保留编码结果中末尾的全部等号(=)。

使用数据万象对大于20MB 的图片进行图片处理会返回什么结果?

对于大于20MB的图片处理请求,数据万象将返回(302),并跳转到对象存储 COS 对应的资源链接进行原图下载。

开启 Guetzli 压缩后未生效,如何解决?

Guetzli 图片压缩是数据万象推出的视觉无损压缩服务,开通 Guetzli 后该存储桶中的图片在下载时会进行 Guetzli 压缩,请求的 HTTP 头部会增加 x-GuetzliState 标识,用以标识 Guetzli 压缩处理的状态。若出现使用 Guetzli 压缩未生效,请按以下步骤进行检查:

  1. 使用此功能需要在数据万象控制台开启 Guetzli 图片压缩 功能,请确认 Guetzli 图片压缩服务状态是否为开启状态。
  2. Guetzli 压缩功能目前仅支持 JPG 格式图片,请确认您所处理的图片是否为 JPG 格式。
  3. 当前 Guetzli 图片压缩服务仅对质量 q>70、像素小于400万的 JPG 图片做处理,请确认您所处理的图片是否符合限制。
  4. 开启 Guetzli 后,首次访问图片会返回普通 JPG 原图,同时启动异步 Guetzli 处理,处理完成后再次请求该图片会得到压缩后的结果图。若您为第一次请求,请重试后确认是否生效。
  5. 目前部分用户暂不支持使用 COS 域名进行处理,若您使用的 COS 域名格式为 <BucketName-APPID>.cos.<Region>.myqcloud.com (例如 examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com)处理后未生效,请替换为万象域名(例如 examplebucket-1250000000.picgz.myqcloud.com)后重试。
目录