Imago

Imago is a lightweight image optimization API for developers. Upload an image or point it at a URL, and Imago resizes, crops, and converts it to modern formats like WebP and AVIF; cutting file sizes without the complexity or cost of a full media platform. One endpoint, transparent pricing, and it drops into any stack in seconds.

原始信息汇总

数据集概述：Imago

Imago 是一个轻量级的图片优化 API，专为开发者设计，旨在简化图片处理流程。它支持通过 URL 或直接上传的方式提供图片，并执行调整大小、裁剪、格式转换（如 WebP、AVIF）等操作，帮助降低文件体积，无需使用复杂的完整媒体平台。

核心功能

• 端点：提供两个入口处理图片。
  • POST /v1/optimize：通过 multipart/form-data 上传图片文件。
  • GET /v1/optimize：通过 url 查询参数指定一个公开的图片 URL。
• 处理能力：支持调整图片的宽度和高度，并提供 contain（适应容器）和 cover（填充并裁剪）两种适配模式。API 不会进行放大操作，输出尺寸不会超过原始图片。
• 格式转换：支持将图片输出为 webp、avif、jpeg 和 png 格式。默认格式为 webp。
• 质量调整：通过 quality 参数（1-100）控制压缩质量（默认 80），该参数对无损的 png 格式无效。
• 元数据剥离：输出图片会自动剥离 EXIF 和颜色配置文件等元数据，以减小文件大小。

技术细节

• 认证方式：通过 RapidAPI 平台进行认证。每次请求需在 Header 中包含 X-RapidAPI-Key（你的 RapidAPI 密钥）和 X-RapidAPI-Host（imago1.p.rapidapi.com）。
• 响应格式：成功时返回 200 OK，响应体为原始图片的二进制字节，格式由 Content-Type 头部指定。失败时返回对应的 HTTP 状态码和 JSON 格式的错误信息。
• 请求限制：上传的图片文件（或通过 URL 获取的图片）大小上限为 15 MB。请求配额和频率限制由 RapidAPI 订阅计划决定。
• 请求处理：处理是无状态的，API 不会存储上传或处理的图片。
• 健康检查：提供 GET /ping 端点（无需认证），用于服务存活检测。

错误码

状态码	名称	说明
400	Bad Request	参数无效、图片损坏或无法解码等。
401	Unauthorized	API 密钥缺失或无效。
403	Forbidden	提供的 URL 指向了内网或私有地址。
413	Payload Too Large	上传的图片超过 15 MB。
429	Too Many Requests	超出订阅计划的配额或速率限制。
500	Internal Server Error	服务器内部错误。
502	Bad Gateway	图片处理器超时或无法获取源图片。
503	Service Unavailable	所有处理槽位繁忙（瞬时负载导致）。

定价

API 提供多个订阅计划，包括 BASIC（免费）、PRO（$7.00/月）、ULTRA（$19.00/月）和 MEGA（$79.00/月）。