API

概要

Convert2WebP API を使用すると、プログラムで画像を形式間で変換できます。画像を含むマルチパート リクエストを送信し、応答本文で変換されたファイルを受け取ります。すべての処理はサーバー側で行われ、ほとんどのファイルの遅延は 1 秒未満です。

認証

認証は必要ありません。 API は無料でオープンです。すべてのリクエストは、IP アドレスごとに 1 分あたり 60 リクエストにレート制限されています。

レート制限

レート制限は IP アドレスごとに適用されます。すべての応答にはレート制限ヘッダーが含まれます。

レート制限ヘッダーはすべての応答に含まれます。 X-RateLimit-Remaining, X-RateLimit-Reset.

エンドポイント

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

curl https://convert2webp.com/api/v1/formats

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

curl https://convert2webp.com/api/v1/health

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

エラーコード

すべてのエラー応答は、次のような JSON 本文を返します。 error 何が問題だったかを説明するオブジェクト。

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}