変換

画像を各形式間で変換します。一般的なウェブ形式に加え、HEIC、JXL、BMP、ICO、JP2、QOI、PSD などの特殊な形式にも対応します。

API エンドポイント

POST /api/v1/tools/image/convert

画像ファイルとJSONの settings フィールドを含むmultipartフォームデータを受け付けます。

パラメータ

パラメータ	型	必須	デフォルト	説明
format	string	はい	-	目標形式: jpg、png、webp、avif、tiff、gif、heic、heif、jxl、bmp、ico、jp2、qoi、psd、ppm、eps、tga
quality	number	いいえ	-	出力品質（1〜100）。jpg、webp、avif、heic などの非可逆形式に適用されます。

対応する出力形式

形式	種類	補足
jpg	非可逆	JPEG、最も互換性が高い
png	可逆	透明度に対応
webp	両方	モダンなウェブ形式、良好な圧縮
avif	非可逆	次世代形式、優れた圧縮
tiff	両方	印刷/出版ワークフロー
gif	可逆	256色に制限
heic / heif	非可逆	Appleエコシステムの形式
jxl	両方	JPEG XL、次世代形式
bmp	可逆	非圧縮ビットマップ
ico	可逆	Windowsアイコン形式
jp2	非可逆	JPEG 2000
qoi	可逆	Quite OK Image形式
psd	レイヤー	Adobe Photoshop（ImageMagickが必要）
ppm	可逆	Portable Pixmap（PPM/PGM/PBM）
eps	ベクター	Encapsulated PostScript
tga	可逆	Targa画像形式

リクエスト例

WebPに変換:

curl -X POST http://localhost:1349/api/v1/tools/image/convert \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"format": "webp", "quality": 85}'

PNG（可逆）に変換:

curl -X POST http://localhost:1349/api/v1/tools/image/convert \
  -H "Authorization: Bearer si_your-api-key" \
  -F "[email protected]" \
  -F 'settings={"format": "png"}'

レスポンス例

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.webp",
  "originalSize": 2450000,
  "processedSize": 680000
}

補足

• 出力ファイル名の拡張子は目標形式に合わせて自動で更新されます。
• SVGの入力は変換前に300 DPIでラスタライズされます。
• PSD変換にはサーバーにImageMagickがインストールされている必要があります。
• BMP、EPS、ICO、JP2、JXL、PPM、QOI、TGA は専用のCLIエンコーダーを使用し、Sharpの処理をバイパスします。
• HEIC/HEIF のエンコードはシステムのHEICエンコーダーライブラリを使用します。
• 入力形式は幅広く、JPEG、PNG、WebP、AVIF、TIFF、GIF、HEIC、RAW（CR2、NEF、ARW など）、PSD、SVG、BMP などに対応します。