图片EXIF信息提取 - 澄曜API Hub

基本信息

接口调用前需要确认的核心配置。

接口地址/api/image_exif

请求方式GET,POST

返回格式JSON

调用权限VIP专享

ApiKey需要

创建时间2026-05-18

脚本路由image_exif

📊 当前您的权限信息

会员等级

免费用户

调用频率限制

100 次/分钟

可访问API类型

仅免费API

💡 注册成为普通会员可免审核即时获得 Key，调用频率提升至 180 次/分钟。升级VIP 可解锁全部API，调用频率提升至 300 次/分钟。

请求参数说明

必填参数必须传入，示例值可直接用于联调。

参数名	必填	类型	说明	示例值
`key`	是	string	VIP会员专享API，需要审核通过的ApiKey。请注册账号并升级VIP后使用。	`YOUR_API_KEY`
`image_base64`	否	string	Base64编码的图片(三选一)	`iVBORw0KGgo...`
`result.has_exif`	否	boolean	是否包含EXIF	`true`
`image_url`	否	string	图片URL(三选一)	`https://example.com/photo.jpg`
`result.file_info`	否	object	文件基本信息	`{}`
`image`	否	file	上传文件(三选一)	`(文件)`
`result.exif.camera`	否	object	相机信息	`{}`
`result.exif.parameters`	否	object	拍摄参数	`{}`
`format`	否	string	输出格式:detailed/simple/json	`simple`
`result.exif.gps`	否	object	GPS信息	`{}`
`include_gps`	否	boolean	是否包含GPS信息	`true`
`result.summary`	否	object	简化摘要(simple模式)	`{}`
`include_thumbnail`	否	boolean	是否返回缩略图信息	`false`
`timezone`	否	string	时区	`Asia/Shanghai`

示例代码

优先使用示例地址测试请求参数是否正确。

示例请求

https://api.ruseo.cn/api/image_exif?key=YOUR_API_KEY&image_base64=iVBORw0KGgo...&result.has_exif=true&image_url=https%3A%2F%2Fexample.com%2Fphoto.jpg&result.file_info=%7B%7D&image=%28%E6%96%87%E4%BB%B6%29&result.exif.camera=%7B%7D&result.exif.parameters=%7B%7D&format=simple&result.exif.gps=%7B%7D&include_gps=true&result.summary=%7B%7D&include_thumbnail=false&timezone=Asia%2FShanghai

cURL

curl "https://api.ruseo.cn/api/image_exif?key=YOUR_API_KEY&image_base64=iVBORw0KGgo...&result.has_exif=true&image_url=https%3A%2F%2Fexample.com%2Fphoto.jpg&result.file_info=%7B%7D&image=%28%E6%96%87%E4%BB%B6%29&result.exif.camera=%7B%7D&result.exif.parameters=%7B%7D&format=simple&result.exif.gps=%7B%7D&include_gps=true&result.summary=%7B%7D&include_thumbnail=false&timezone=Asia%2FShanghai"

PHP

$url = 'https://api.ruseo.cn/api/image_exif?key=YOUR_API_KEY&image_base64=iVBORw0KGgo...&result.has_exif=true&image_url=https%3A%2F%2Fexample.com%2Fphoto.jpg&result.file_info=%7B%7D&image=%28%E6%96%87%E4%BB%B6%29&result.exif.camera=%7B%7D&result.exif.parameters=%7B%7D&format=simple&result.exif.gps=%7B%7D&include_gps=true&result.summary=%7B%7D&include_thumbnail=false&timezone=Asia%2FShanghai';
$response = file_get_contents($url);
$data = json_decode($response, true);

JavaScript

fetch('https://api.ruseo.cn/api/image_exif?key=YOUR_API_KEY&image_base64=iVBORw0KGgo...&result.has_exif=true&image_url=https%3A%2F%2Fexample.com%2Fphoto.jpg&result.file_info=%7B%7D&image=%28%E6%96%87%E4%BB%B6%29&result.exif.camera=%7B%7D&result.exif.parameters=%7B%7D&format=simple&result.exif.gps=%7B%7D&include_gps=true&result.summary=%7B%7D&include_thumbnail=false&timezone=Asia%2FShanghai')
  .then(res => res.json())
  .then(data => console.log(data));

返回说明

实际返回内容以接口脚本处理结果为准。

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "route": "image_exif",
        "example": true
    }
}

返回参数说明

参数名	类型	说明	示例值
`code`	integer	业务状态码，0 表示请求成功，其他值表示失败。	`0`
`msg`	string	接口调用结果说明。	`success`
`data`	object	接口返回的业务数据对象。	`{}`
`data.input`	object	输入参数信息。	`{}`
`data.input.source_type`	string	图片来源类型：base64、url、upload。	`url`
`data.input.format`	string	输出格式：simple（简化）、detailed（详细）。	`detailed`
`data.input.include_gps`	boolean	是否包含GPS信息。	`true`
`data.input.include_thumbnail`	boolean	是否包含缩略图信息。	`false`
`data.input.timezone`	string	时区设置。	`Asia/Shanghai`
`data.result`	object	EXIF解析结果对象。	`{}`
`data.result.has_exif`	boolean	图片是否包含EXIF信息。	`true`
`data.result.summary`	object	简化模式下的摘要信息（format=simple时返回）。	`{}`
`data.result.summary.camera`	string	相机型号，格式为"品牌型号"。	`Canon EOS 5D Mark IV`
`data.result.summary.taken_at`	string	拍摄时间，格式为YYYY-MM-DD HH:mm:ss。	`2024-01-15 14:30:25`
`data.result.summary.resolution`	string	图片分辨率，格式为"宽x高"。	`5472x3648`
`data.result.summary.file_size`	string	文件大小，带单位。	`8.52 MB`
`data.result.summary.iso`	string	ISO感光度值。	`400`
`data.result.summary.aperture`	string	光圈值，格式为f/数值。	`f/2.8`
`data.result.summary.shutter_speed`	string	快门速度。	`1/250s`
`data.result.summary.focal_length`	string	焦距。	`85mm`
`data.result.summary.has_gps`	boolean	是否包含GPS定位信息。	`true`
`data.result.summary.location`	string	GPS坐标，格式为"纬度, 经度"。	`31.2304, 121.4737`
`data.result.file_info`	object	文件基本信息（format=detailed时返回）。	`{}`
`data.result.file_info.filename`	string	文件名。	`IMG_20240115_143025.jpg`
`data.result.file_info.mime_type`	string	MIME类型。	`image/jpeg`
`data.result.file_info.size_bytes`	integer	文件大小（字节）。	`8934567`
`data.result.file_info.dimensions`	object	图片尺寸对象。	`{}`
`data.result.file_info.dimensions.width`	integer	图片宽度（像素）。	`5472`
`data.result.file_info.dimensions.height`	integer	图片高度（像素）。	`3648`
`data.result.exif.camera`	object	相机信息对象。	`{}`
`data.result.exif.camera.make`	string	相机品牌/制造商。	`Canon`
`data.result.exif.camera.model`	string	相机型号。	`Canon EOS 5D Mark IV`
`data.result.exif.camera.software`	string	处理软件名称。	`Adobe Photoshop CC`
`data.result.exif.camera.serial_number`	string	相机序列号（如果有）。	`1234567890`
`data.result.exif.shooting`	object	拍摄时间信息对象。	`{}`
`data.result.exif.shooting.date_time`	string	文件修改时间。	`2024-01-15 14:30:25`
`data.result.exif.shooting.date_time_original`	string	原始拍摄时间。	`2024-01-15 14:30:25`
`data.result.exif.shooting.date_time_digitized`	string	数字化时间。	`2024-01-15 14:30:25`
`data.result.exif.shooting.timezone_offset`	string	时区偏移量。	`+08:00`
`data.result.exif.parameters`	object	拍摄参数对象。	`{}`
`data.result.exif.parameters.exposure_time`	string	曝光时间/快门速度。	`1/250s`
`data.result.exif.parameters.f_number`	string	光圈值。	`f/2.8`
`data.result.exif.parameters.iso_speed`	integer	ISO感光度。	`400`
`data.result.exif.parameters.focal_length`	string	焦距。	`85mm`
`data.result.exif.parameters.focal_length_35mm`	string	35mm等效焦距。	`85mm`
`data.result.exif.parameters.exposure_program`	string	曝光程序：Manual、Normal、Aperture Priority等。	`Aperture Priority`
`data.result.exif.parameters.metering_mode`	string	测光模式：Average、Spot、Pattern等。	`Pattern`
`data.result.exif.parameters.flash`	string	闪光灯状态：Fired、Off等。	`Off`
`data.result.exif.parameters.white_balance`	string	白平衡：Auto或Manual。	`Auto`
`data.result.exif.parameters.exposure_bias`	string	曝光补偿值。	`+0.3 EV`
`data.result.exif.parameters.max_aperture`	string	镜头最大光圈。	`f/1.8`
`data.result.exif.parameters.digital_zoom_ratio`	string	数字变焦比率。	`1.0`
`data.result.exif.parameters.scene_capture_type`	string	场景类型：Standard、Landscape、Portrait、Night。	`Portrait`
`data.result.exif.parameters.contrast`	string	对比度设置：Normal、Low、High。	`Normal`
`data.result.exif.parameters.saturation`	string	饱和度设置：Normal、Low、High。	`Normal`
`data.result.exif.parameters.sharpness`	string	锐度设置：Normal、Low、High。	`Normal`
`data.result.exif.lens`	object	镜头信息对象。	`{}`
`data.result.exif.lens.lens_make`	string	镜头品牌。	`Canon`
`data.result.exif.lens.lens_model`	string	镜头型号。	`EF 85mm f/1.8 USM`
`data.result.exif.lens.lens_serial_number`	string	镜头序列号。	`12345678`
`data.result.exif.gps`	object	GPS定位信息对象（需要include_gps=true）。	`{}`
`data.result.exif.gps.latitude`	float	纬度（十进制）。	`31.2304`
`data.result.exif.gps.longitude`	float	经度（十进制）。	`121.4737`
`data.result.exif.gps.altitude`	float	海拔高度（米）。	`12.5`
`data.result.exif.gps.latitude_ref`	string	纬度参考：N（北纬）或S（南纬）。	`N`
`data.result.exif.gps.longitude_ref`	string	经度参考：E（东经）或W（西经）。	`E`
`data.result.exif.gps.altitude_ref`	string	海拔参考：Sea Level或Below Sea Level。	`Sea Level`
`data.result.exif.gps.timestamp`	string	GPS时间戳（UTC）。	`06:30:25 UTC`
`data.result.exif.gps.map_url`	string	Google地图链接。	`https://www.google.com/maps?q=31.2304,121.4737`
`data.result.exif.orientation`	object	图片方向信息对象。	`{}`
`data.result.exif.orientation.value`	integer	方向值（1-8）。	`1`
`data.result.exif.orientation.description`	string	方向描述：Horizontal、Rotate 90 CW等。	`Horizontal (normal)`
`data.result.exif.orientation.rotation_degrees`	integer	需要旋转的角度。	`0`
`data.result.thumbnail`	object	缩略图信息对象（需要include_thumbnail=true）。	`{}`
`data.result.thumbnail.available`	boolean	是否有缩略图。	`true`
`data.result.thumbnail.width`	integer	缩略图宽度。	`160`
`data.result.thumbnail.height`	integer	缩略图高度。	`120`
`data.result.thumbnail.mime_type`	string	缩略图MIME类型。	`image/jpeg`
`data.meta`	object	元数据对象。	`{}`
`data.meta.processed_at`	string	处理时间。	`2024-01-15 14:35:00`
`data.meta.processing_time_ms`	integer	处理耗时（毫秒）。	`125`

调试参数

请求方式接口地址 key * image_base64 result.has_exif image_url result.file_info image result.exif.camera result.exif.parameters format result.exif.gps include_gps result.summary include_thumbnail timezone

响应结果

◔ --

点击左侧“发送请求”查看结果...