Convert API

服务端图片转换。POST 一张图片，返回 AVIF/WebP/PNG/JPEG。

是什么？

POST /api/convert 接收 multipart 表单，上传图片并可选指定格式与质量，响应为转换后的图片二进制。请求中必须携带有效的 API Key（使用 GitHub 登录后在 API 密钥页创建）。

认证

每次请求需在请求头中带上你的 API Key：

Authorization: Bearer YOUR_API_KEY

创建与管理密钥（需先登录）：

API 密钥 →

接口

POST /api/convert

请求（multipart/form-data）

字段	必填	说明
file	✅	图片文件（AVIF、WebP、PNG、JPEG、GIF）。最大 20MB。
format	-	输出格式：avif、webp、png、jpeg。默认 avif。
quality	-	质量 1–100。默认 75。png 时忽略。
speed	-	AVIF 编码速度 0–10（越大越快、压缩越低）。默认 5。

示例

cURL

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F file=@image.png \
  -F format=avif \
  -F quality=80 \
  https://getavif.com/api/convert \
  -o out.avif

Fetch（JavaScript）

const formData = new FormData();
formData.append("file", imageFile);
formData.append("format", "avif");
formData.append("quality", "80");

const res = await fetch("https://getavif.com/api/convert", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${YOUR_API_KEY}`,
  },
  body: formData,
});

if (!res.ok) throw new Error(await res.text());
const blob = await res.blob();
// e.g. save or use blob

将 YOUR_API_KEY 换成你的 API 密钥即可。

响应

200：图片二进制，带 Content-Type（如 image/avif）和 Content-Disposition attachment。400：请求不合法。401：缺少或无效的 API Key。503：转换或密钥校验不可用。

错误

所有错误返回带 "error" 字段的 JSON。可用 GET /api/convert 查看简短用法说明。