You need to enable JavaScript to run this app.
导航
veImageX
  • 文档首页
    • /veImageX/API 参考/其他处理 API/查询图片 meta 信息
查询图片 meta 信息
最近更新时间：2024.05.10 15:36:31首次发布时间：2021.02.23 10:42:29
我的收藏

图片 meta 信息包括图片分辨率、图片格式、图片大小、图片 MD5 值、色彩模型等基本信息，还包括可能存在的 EXIF 信息。如果原图为动图，还将包含动图帧数以及时长信息。

计费说明

查询图片 meta 信息功能属于 veImageX 的基础图片处理计费项，您在调用该接口时会产生相应费用，当前支持后付费和预付费两种计费方式。

注意事项

  • 对于图片内色彩模型的获取，仅支持处理 jpeg、webp、png、heic、avif 格式，且各格式可返回的模型如下所示：

    • jpeg：gray、ycbcr、rgba、cmyk
    • webp：ycbcr、nycbcra、nrgba
    • png：rgba、rgba64、nrgba、nrgba64、gray、gray16、palette
    • heic：ycbcr
    • avif：ycbcr

  • 对于图片内压缩质量参数的获取，仅支持处理 jpeg 格式。

接口形式

  • 普通 URL 采用以下拼接方式：
${domain}/${image_uri}~info
  • 鉴权 URL (带-sign/-private) 不能直接替换 info，需要服务端重新下发 URL，在模板参数传入 info。

说明

  • domain：您在 veImageX 服务绑定的正常可用域名，您可在控制台的服务管理页面，查看绑定的域名。
  • image_uri：相同服务下的图片存储 URI，您可在控制台的资源管理页面，获取上传文件的存储 URI；或者调用 GetImageStorageFiles 获取指定服务下的存储 URI。

请求示例

  • 普通 URL：
http://p3-imagex.byteimg.com/imagex-rc/preview.jpg~info
  • 鉴权 URL：
https://p6-domaingo-sign.byteimg.com/tos-cn-i-6m**os/1.png~info?x-expires=1700143965&x-signature=Z0z4U7Z****PgJR22tU%3D

返回示例

{
    "width": 1023,                             // 图片宽度，单位：像素(px)
    "height": 683,                             // 图片高度，单位：像素(px)
    "format": "jpeg",                          // 图片格式，如png、jpeg、gif、bmp等
    "size": 63859,                             // 图片大小，单位：Bytes
    "md5": "d2368141ea8201**0a90eed55cfaaef",  // 图片 MD5 值
    "framecnt": 1,                             // 帧数，静图为固定值 1
    "colorModel":  "ycbcr"                     // 色彩模型
    "duration": 0,                             // 时长，静图不包含此字段
    "orientation": {},                         // 图片旋转信息
    "quality": 80                              // 压缩质量参数，值越小，压缩率越高，画质越差
}

若原图片包含 EXIF 信息，则将在 exif 字段中返回。如下所示。

{
    "width": 1063,
    "height": 800,
    "format": "jpeg",
    "size": 198975,
    "md5": "62978fe3874f7c6a66b91c04083d0af0",
    "framecnt": 1,
    "colorModel":  "ycbcr"
    "exif": {
        "ColorSpace": "sRGB",
        "ExifVersion": "Exif Version 2.1",
        "FlashPixVersion": "FlashPix Version 1.0",
        "Orientation": "Top-left",
        "PhotometricInterpretation": "RGB",
        "PixelXDimension": "1063",
        "PixelYDimension": "800",
        "ResolutionUnit": "Inch",
        "XResolution": "72",
        "YResolution": "72"
    },
    "orientation": {},
    "quality": 80 
}