mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages

All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.

2026-07-11 13:52:47 +08:00

3.3 KiB

Raw Blame History

description, i18n_source_hash, i18n_provenance, i18n_output_hash

description	i18n_source_hash	i18n_provenance	i18n_output_hash
AVIF、JXL、HEIC などのモダンな形式を含め、画像を各形式間で変換します。	562f8270e8c3	human	7676d19fa60d

変換

画像を各形式間で変換します。一般的なウェブ形式に加え、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 "file=@photo.jpg" \
  -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 "file=@photo.jpg" \
  -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 などに対応します。

3.3 KiB Raw Blame History Unescape Escape

変換