ImageConverter

Convert images between WebP, AVIF, JPEG, PNG, GIF, BMP, WBMP and TIFF in a single multipart request — fast, high-quality transcoding with adjustable quality and transparency handling.

原始信息汇总

数据集概述：ImageConverter

基本信息

• API名称：ImageConverter
• 提供者：Lukáš Moulis
• 订阅人数：1
• 类别：Video, Images
• 基础定价：$0.00 / mo（BASIC）

核心功能

该API能够在 WebP、AVIF、JPEG、PNG、GIF、BMP、WBMP 和 TIFF 这八种图像格式之间进行相互转换。它通过简单的 HTTP 调用，提供高质量、快速处理的图像转码服务。图像以 multipart/form-data 形式上传，转换后的字节流直接返回，服务端不存储任何内容。

支持的格式转换矩阵

格式	作为输入	作为输出
JPG / JPEG	✅	✅
PNG	✅	✅
GIF	✅	✅
BMP	✅	✅
WBMP	✅	✅
TIF / TIFF	✅	✅
WEBP	✅	✅
AVIF	✅	✅

API 端点

API 提供两种调用方式：

1. 通用端点

• POST /convert：接受任何支持的输入格式，通过 format 参数指定任意支持的输出格式。这是唯一支持 WEBP ↔ AVIF 相互转换的端点。

2. 专用快捷端点

• POST /webp/to：将图像转换为 WEBP 格式。
• POST /webp/from：将 WEBP 图像转换为经典格式（JPEG, PNG 等），但不支持转换为 AVIF。
• POST /avif/to：将图像转换为 AVIF 格式。
• POST /avif/from：将 AVIF 图像转换为经典格式（JPEG, PNG 等），但不支持转换为 WEBP。

关键特性

• 质量控制：可选的 quality 参数（1–100，默认80），仅对 WEBP 和 AVIF 这类有损编码的格式输出有效。
• 透明通道处理：当源图像包含透明通道而目标格式不支持时，会自动将透明区域合成到不透明的白色背景上，避免转换失败。
• 格式检测：输入格式通过文件内容检测，而非声明的 Content-Type。
• 无服务器存储：所有转换后的数据流式返回，不持久化保存。
• 正确的 MIME 类型：响应头 Content-Type 会被设置为目标格式对应的 MIME 类型。

使用场景

• 优化网站图片，转换为 WebP 或 AVIF 以加快页面加载速度。
• 为 <picture> 元素生成同一资源的 WebP 和 AVIF 版本。
• 将 WebP 或 AVIF 转换回 PNG、JPEG 等经典格式，以兼容旧客户端或平台。
• 统一处理混合格式的上传文件，转换成一种一致的输出格式后再分发至 CDN。

错误处理

• 400 Bad Request：输入格式与请求输出格式相同、图像无法读取、quality 值超出范围或 format 无效。
• 401 Unauthorized：缺少或无效的认证凭据。
• 503 Service Unavailable：服务器端的 AVIF 编码器/解码器暂时不可用。

请求示例

• 通用转换（PNG to AVIF, Quality 90）： bash curl -X POST https://webpimageconverter2.p.rapidapi.com/convert?format=AVIF&quality=90 -H X-RapidAPI-Key: <your-key> -H X-RapidAPI-Host: webpimageconverter2.p.rapidapi.com -F image=@photo.png --output photo.avif

• 专用端点（AVIF to JPEG）： bash curl -X POST https://webpimageconverter2.p.rapidapi.com/avif/from?format=JPEG -H X-RapidAPI-Key: <your-key> -H X-RapidAPI-Host: webpimageconverter2.p.rapidapi.com -F image=@photo.avif --output photo.jpg