图片自动旋正

接口标识: imageorient 价格: 0.0005 元/次 VIP免费同步响应

接口介绍
接口文档
在线测试

接口简介

图片自动旋正接口把方向不对的图片转正：依据图中文字的排列方向判断正倒，自动旋转到文字横排可读，纠正角度为 90 度或 270 度。除旋正后的图片外，还返回是否发生了旋转与实际旋转角度，方向本就正常的图片原样输出、不做任何改动，批量处理时可据此区分哪些图被纠正过。适合扫描件、手机拍摄的文档票据与截图素材在识别或归档前的方向预处理。

详细介绍

常见问题

Q：什么是图片自动旋正？

A：图片自动旋正是基于图片上的文字排版方向，智能检测图片是否被90°/270°旋转拍摄（如竖拍横向证件），并自动将图片转正，使文字恢复横排可读状态的服务。

Q：如何判断图片是否需要旋转？

A：通过分析图片中文字的排版布局方向，并结合文字识别置信度进行多重验证后判断，方向正常的图片原样返回，不会误转。

Q：返回结果包含哪些信息？

A：返回旋正后图片的访问地址（image_url，7天内有效）、是否发生旋转（rotated）及实际旋转角度（angle：0/90/270）。

Q：支持哪些图片来源？

A：支持 base64 编码（image 参数，不超过4M）和公网图片URL（image_url 参数）两种方式，二选一传入。

Q：180°倒置的图片能纠正吗？

A：不能。180°倒置的图片文字排版方向与正常图片一致，无法通过排版特征区分，本产品仅处理90°/270°旋转。

Q：适用于哪些场景？

A：适用于证件扫描件方向纠正、手机拍照件批量整理、文档电子化前置处理、图片归档标准化等场景，常作为OCR识别前的预处理步骤。

图片旋正方向纠正旋转矫正图像处理证件转正

接口地址： https://www.phpwc.cn/api/imageorient

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	文件输入（自动识别）：公网URL / Base64(data:开头) / 文件ID(fileid_开头)

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`file_url`	string	旋正后图片的访问地址（7天内有效，请及时下载保存）
`rotated`	boolean	是否发生旋转（true=原图方向异常已纠正，false=原图方向正常原样输出）
`angle`	int	实际旋转角度：0=方向正常未旋转，90/270=已按该角度纠正
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试