Image Cropping API — Subject-Aware Crops to Width × Height

Crop images to custom dimensions while keeping the main subject centered. Specify target width and height, and receive the intelligently cropped result.

原始信息汇总

Image Cropping API — Subject-Aware Crops to Width × Height 数据集概述

基本信息

• 数据集名称: Image Cropping API — Subject-Aware Crops to Width × Height
• 类别: Video, Images
• 提供商: APISphere
• 订阅者数量: 1
• 版本: v1 (current)

定价计划

• BASIC: $0.00 / 月
• PRO: $8.91 / 月
• ULTRA: $89.91 / 月
• MEGA: $269.91 / 月

概述

• 功能: 将图像裁剪至自定义尺寸，同时保持主体居中。
• 核心特性: 指定目标宽度和高度，接收智能裁剪结果。

目标用户

适用场景

• 内容平台生成各种尺寸的缩略图。
• 社交媒体工具将图像裁剪至平台特定尺寸。
• 电子商务平台标准化产品图像尺寸。
• 内容管理系统和需要响应式图像裁剪的Web应用程序。
• 开发人员构建批量图像处理流水线。

不适用场景

• 无需裁剪的调整大小（此API裁剪至精确尺寸）。
• 背景移除（请参阅背景移除端点）。
• 裁剪为非矩形形状。
• 实时视频帧裁剪（单图像端点）。

端点

• 端点: POST /v1/image/smart-crop
• 描述: 上传图像并指定目标宽度和高度，以接收主体感知的裁剪结果。

请求与响应示例

示例请求

bash curl -X POST "https://your-rapidapi-host/v1/image/smart-crop" -H "X-RapidAPI-Key: YOUR_API_KEY" -F "image=@photo.jpg" -F "width=400" -F "height=400"

示例响应

• 成功: 直接返回二进制图像数据，Content-Type为image/png或image/jpeg，裁剪至指定尺寸。
• 错误: 返回包含meta、data、warnings和error字段的标准错误信封。

主要优势

• 主体感知裁剪: 自动将主体保持在画面中。
• 自定义尺寸: 可指定任何目标宽度和高度（最小10像素）。
• 直接二进制输出: 接收可直接使用的裁剪图像。
• 广泛的格式支持: 接受JPEG、PNG、BMP、WEBP和GIF格式。
• 一致的错误格式: 错误时返回标准的meta、data、warnings、error信封。

输入参数

参数	类型	必需	默认值	描述
image	文件	是	—	源图像（JPEG、PNG、BMP、WEBP、GIF），最大10 MB
width	整数	是	—	目标宽度（像素），最小10
height	整数	是	—	目标高度（像素），最小10

验证与错误

• 缺少文件: image字段为必需，缺失则返回400错误。
• 无效格式: 仅接受JPEG、PNG、BMP、WEBP和GIF文件，其他格式返回400错误。
• 文件过大: 图像超过10 MB将被拒绝，返回400错误。
• 宽度过小: width必须至少10像素，低于此值返回400错误。
• 高度过小: height必须至少10像素，低于此值返回400错误。
• 上游错误: 如果处理服务超时或失败，返回502错误。
• 服务器错误: 意外故障返回500状态，错误详情在error字段中。