全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

设置灰度

最近更新时间:2025-11-07 14:41:32

接口

colorspace

描述

将图片调整为灰色,适用于文档、图表(如工程图纸、表格)。转为灰度后,可去除背景色干扰,让文字、线条更清晰,便于打印或 OCR 识别。

说明

该接口操作需要是Bucket Owner或具有ks3:GetObject权限。

请求

请求语法

https://<bucketName>.<endpoint>/<objectKey>@base@tag=colorspace&v=<value>

请求参数

参数名称

参数含义

是否必填

取值范围

tag

操作标志

colorspace

v

调整图片颜色模式,取值为 gray 将图片置灰

gray

请求头部

该请求不需要设置特殊的头部。

响应

响应头部

头部名称

是否必填

说明

Content-Type

MIME类型,成功时为图片固定的MIME类型image/*,失败时为application/json

响应内容

  • 如果请求处理成功,返回图片的二进制图片数据。

  • 如果请求失败,则返回如下JSON格式的内容:

{
    "code":  <code String>,
    "message":  <ErrorMessage String>,
    "requestId":  <requestId String>
}

特殊错误

HTTP状态码

描述

400

  • 请求参数错误

  • 请求的文件不是图片或者是KS3不支持的图片格式

403

签名不匹配或无操作对应权限

404

请求的资源不存在

500

服务器端操作失败。如果遇到此种错误,请及时联系我们

示例

原图

  • 处理参数如下:

    • 操作参数:colorspace

    • 设置v的值为gray

http://ks3-resources.ks3-cn-beijing.ksyuncs.com/suiyi.jpg@base@tag=colorspace&v=gray
  • 目标图

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈