TidyArchive Deskew API

Automatically straighten, rotate, and crop scanned photos, documents, and archive images.

原始信息汇总

TidyArchive Deskew API 数据集详情总结

基本信息

• 名称: TidyArchive Deskew API
• 类别: Video, Images（视频、图像）
• 创建者: jas2
• 基础URL: https://api.tidyarchive.com

功能概述

TidyArchive Deskew API 是一个用于自动矫正倾斜扫描件和照片的简单 HTTP API。它能够检测页面的倾斜角度，旋转图像使其水平，并裁剪空白边框，使内容充满画面。该 API 基于 OpenCV 经典计算机视觉算法实现，无需加载重型机器学习模型，请求快速且成本低廉。

主要用途

• 矫正家谱和家庭照片的歪斜扫描件
• 档案和图书馆数字化预处理
• 准备 OCR 前的文档处理（对齐图像可提升文字识别效果）
• 处理书页、收据、信件和历史记录

计费方案

套餐	价格
BASIC	$0.00 / 月
PRO	$9.00 / 月
ULTRA	$29.00 / 月
MEGA	$79.00 / 月

接口端点

POST /v1/deskew

• 功能: 矫正并裁剪单个图像
• 参数（multipart/form-data）:
  • file: 图像文件（PNG、JPG、JPEG、TIFF、TIF、WEBP、HEIC，最大 25 MB，最大 1 亿像素）
  • url: 图像 URL（与 file 二选一）
  • crop_mode: 裁剪模式（可选，默认 close；close 紧密裁剪，flush 保留小均匀边距）
• 响应: 返回处理后图片的托管链接（有效 24 小时）及元数据（旋转角度、输入/输出尺寸、输出格式、字节数）
• 特殊功能: 若请求头包含 Accept: image/*，直接返回图像字节而非 JSON

POST /v1/batch

• 功能: 批量矫正 ZIP 压缩包中的图像
• 参数（multipart/form-data）:
  • file: ZIP 文件（内部支持 PNG、JPG、JPEG、TIFF、TIF、WEBP、HEIC，最大 200 MB，最多 200 张图像）
  • url: ZIP 文件 URL（与 file 二选一）
• 响应: 返回结果 ZIP 链接及 manifest.json，包含每个文件的状态和元数据
• 自动跳过: 不支持的文件类型及 macOS 隐藏元数据文件夹（__MACOSX）
• 输出命名: 处理后的图像命名为 <原文件名>_rotated_cropped.jpg

GET /v1/files/{id}

• 功能: 根据文件 ID 检索已处理的文件（图像或 ZIP）
• 有效期: 文件保留 24 小时
• 错误: 404（未知或过期 ID）

认证方式

• RapidAPI 订阅用户: 自动处理认证，无需额外设置
• 直接调用（服务器对服务器/本地测试）: 需通过以下任一方式发送 API 密钥:
  • 请求头 X-API-Key: YOUR_KEY
  • 请求头 Authorization: Bearer <YOUR_API_KEY>
• 无效密钥返回 401 Invalid or missing API key

错误码

代码	含义
400	缺少 file/url、类型不支持或 crop_mode 无效
401	缺少或无效 API 密钥
413	文件、图像或压缩包过大
429	超出速率限制或月度配额
500	处理失败
404	文件 ID 未知或已过期

使用限制

• 单张图像：最大 25 MB，最大 1 亿像素
• ZIP 批量：最大 200 MB，每批最多 200 张图像
• 处理文件存储 24 小时后删除
• 速率限制（每分钟请求数）：
  • 免费版：10 次
  • 专业版：60 次
  • 商业版：200 次
  • 管理版：1000 次

其他说明

• 输出格式始终为 JPEG
• crop_mode=close 适合文档紧密裁剪；crop_mode=flush 适合保留统一小边距
• 提供 /docs 端点（Swagger UI 交互式文档）和 /openapi.json 端点（完整 OpenAPI 架构）
• 启用 CORS，可从浏览器代码直接调用