You need to enable JavaScript to run this app.
veImageX

veImageX

请输入
  • 文档首页
    • veImageXAPI 参考其他处理API查询图片 meta 信息
复制全文
我的收藏
其他处理API
查询图片 meta 信息
复制全文
我的收藏
查询图片 meta 信息

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

计费说明

查询图片 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 格式。
  • 要获取 AIGC 元数据，请确保您的图片格式和 AIGC 元数据位置符合以下要求。
    • jpeg：AIGC 元数据需位于 App 11 字段或 EXIF 的 Usercomment 字段。
    • png：AIGC 元数据需位于 tEXt chunk 信息或 EXIF 的 Usercomment 字段。
    • webp：AIGC 元数据需位于 XMP 元素/属性字段或 EXIF 的 Usercomment 字段。
    • avif/heic：AIGC 元数据需位于 EXIF 的 Usercomment 字段。

接口形式

  • 普通 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 信息和 AIGC 元数据信息，则在 exif 和 aigc 字段中返回。其中，EXIF 信息支持的具体字段和含义，详见标准 EXIF 标签。

{
    "width": 1063,
    "height": 800,
    "format": "jpeg",
    "size": 198975,
    "md5": "62978fe3874f****c04083d0af0",
    "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",
        "Usercomment":"xxxxx" 
    },
    "aigc": {
        "Label": "1", // 标签。1 表示由 AI 生成，2 表示可能由 AI 生成，3 表示疑似由 AI 生成。
        "ContentProducer": "00****", // 服务提供者编码。
        "ProduceID": "test****Id", // 内容制作编号。
        "ReservedCode1": "ewogICAgIm****UiLAp9", // 预留字段。
        "ContentPropagator": "000123", // 内容传播服务提供者。
        "PropagateID": "testPropagatorId", // 内容传播编号。
        "ReservedCode2": "ewogICAg*****UyIiwKfQ" // 预留字段。
    },
    "orientation": {},
    "quality": 80 
}
最近更新时间：2025.12.17 17:43:42
这个页面对您有帮助吗？
有用
有用
无用
无用