跳至主要內容

尋找下一個工具

說明文件/API/圖片 API:壓縮、調整大小和轉換格式
API

圖片 API:壓縮、調整大小和轉換格式

在一次管線呼叫中調整圖片尺寸、裁切、旋轉、按品質或目標位元組數壓縮,並將圖片轉換為 JPG、PNG、WebP 或 AVIF。

簡要回答

呼叫 POST /api/v1/pipeline/,傳入 sourceKey 和步驟 {"operation":"image","pipeline":[…]},其中最多可列出 8 個操作:resize(maxWidth、maxHeight)、crop(x、y、width、height)、rotate(degrees)、compress(quality 1–100 或 targetBytes)和 convert(jpg、png、webp、avif)。對於已在「我的文件」中的圖片,請使用 /documents/{documentId}/process/ 並傳入 {"operation":"image","pipeline":[…]}。

為網頁壓縮圖片

典型的產品圖管線會限制尺寸並轉換為 WebP。在我們的測試中,一張 224 KB 的 PNG 在約 4 秒內變成了寬 400 px、大小 30 KB 的 WebP。

curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'

達到指定的檔案大小

上傳入口網站經常要求「小於 200 KB」。請使用帶 targetBytes 的 compress,而不是 quality;Worker 會搜尋能滿足要求的最高品質。目標值必須介於 API 允許的最小值和最大值之間(最大 20 MB)。

{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }

將圖片步驟與 PDF 和 OCR 串聯

管線可以在圖片步驟之後繼續:新增 {"operation":"convert","format":"pdf"} 將結果封裝為 PDF,或新增 {"operation":"ocr","format":"pdf"} 使其可搜尋。當下一步需要時,圖片步驟會自動輸出 PNG。

常見問題

壓縮會移除中繼資料嗎?

重新編碼的圖片不會保留 GPS 位置等 EXIF 資料,對於公開圖片來說,這通常正是你想要的。

應該選擇哪種格式?

網站用 WebP;最看重相容性時用 JPG;螢幕截圖和線條圖用 PNG;如果你的受眾使用現代瀏覽器,用 AVIF 可以得到最小的檔案。

相關指南