「图片信息提取」是数据鱼API平台提供的图片元信息读取接口,实际插件标识为 imgopt,Base 路径 /api/imgopt,共 4 个路由。它接收一张图片的 Base64 内容,返回宽、高、MIME 类型、通道数、位深与解码后的字节数,适合上传前校验与素材盘点。
先说明一个关键差异:本接口只做信息提取,不压缩、不缩放、不转格式、不清理元数据。插件名与常见「image-compress」叫法容易让人误以为能减小体积,但 stats 返回的 features 只有 info_extraction,没有任何输出图片或质量参数。如果目标是压缩图片,需要另找工具,不能按本文端点实现。
接口本身很轻:info 是唯一业务端点,支持 GET 与 POST;ping 用于探活,stats 返回支持格式与能力清单。所有解析都基于图片头部,不读取 EXIF 中的拍摄地点、设备与时间。
方法 | 路径 | 说明 | 鉴权 |
|---|---|---|---|
GET | /api/imgopt/ping | 健康检查,返回版本 | 文档标称免鉴权 |
GET | /api/imgopt/stats | 返回能力与支持格式 | 需要 |
POST | /api/imgopt/info | 解析 Base64 图片,返回尺寸与格式信息 | 需要 |
GET | /api/imgopt/info | 与 POST 相同的解析能力,参数走查询串 | 需要 |
鉴权使用 X-API-Key 请求头或 ?api_key= 查询参数,未携带返回 4011,无效返回 4013。响应统一为 {code, msg, data},code 为 0 表示成功。4001 为缺少 data,4002 为参数或输入不合法,4003 为取值不在支持列表,4004 为查询目标未收录,4040 为路由不存在,4050 为方法不允许;5000 与 5001 为服务内部错误,5031 与 5032 表示上游依赖不可用。
POST 支持 JSON body 或表单,字段名与查询参数一致。图片 Base64 往往很长,POST 明显比 GET 合适;GET 把整段 Base64 放进 URL,容易触达代理与服务器的 URL 长度上限,也会把图片内容写进访问日志。
需要注意,文档把 ping 标为免鉴权,但同目录的鉴权中间件对所有非 OPTIONS 请求统一校验 Key。为兼容不同部署,调用 ping 时也带上 Key 更稳妥。
用途:把 Base64 图片解析为宽高、MIME 与体积等基础信息。
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
data | string | 是 | 图片的 Base64 字符串,不是文件路径,也不是普通 URL |
返回字段 | 类型 | 说明 |
|---|---|---|
width | int | 图片宽度,单位像素 |
height | int | 图片高度,单位像素 |
mime | string | 图片 MIME 类型,如 image/jpeg |
channels | int/null | 颜色通道数,部分格式可能为 null |
bits | int/null | 每通道位深,部分格式可能为 null |
size_bytes | int | Base64 解码后的原始字节数 |
data 必须是纯 Base64。浏览器 FileReader 的 readAsDataURL 会生成 data:image/png;base64, 前缀,直接提交通常会被判为非法 Base64;上传前应截掉逗号前的头部,只保留编码正文。Base64 长度约为原始字节数的 4/3,size_bytes 返回的是解码后大小,不是字符串长度。
示例中的响应只覆盖成功路径。invalid base64 在文档的自动化探测记录中返回 4002;当前实现也可能以 code=0 携带 data.error 的形式返回解析失败,因此调用方不能只看 HTTP 200,还要同时检查 code 与 data.error。图片格式不在支持列表、头部损坏或数据截断时,同样可能进入失败分支。
POST /api/imgopt/info?api_key=YOUR_KEY
Content-Type: application/json
{"data":"iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB..."}原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。