图片 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。

请求示例

• 普通 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 
}