API：快速入門

透過 REST API 自動處理圖片和 PDF。

存取與金鑰

登入 Levomio，在設定中建立金鑰。複製金鑰，取代所選用戶端中的 YOUR_API_KEY。請勿公開金鑰。

API：快速入門

此範例使用 1 點數將 photo.png 轉換為 WebP。將 LEVOMIO_API_KEY 設為你的金鑰，然後在同一終端機中執行指令。需要 Bash、curl 和 uuidgen。

1. 建立任務

export LEVOMIO_API_KEY='YOUR_API_KEY'
export LEVOMIO_ORIGIN='https://levomio.com'
TASK_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
INPUT_ID=$(uuidgen | tr '[:upper:]' '[:lower:]')
OPTIONS='{"formats":["webp"],"zip":{"enabled":true}}'

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data "{\"taskId\":\"$TASK_ID\",\"type\":\"convert\",\"options\":$OPTIONS}"

2. 上傳圖片

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/inputs" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -F "taskFileInputId=$INPUT_ID" -F 'position=0' -F '[email protected]'

3. 開始處理 — 最多 1 點數

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID/start" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" \
  -H 'Content-Type: application/json' \
  --data "{\"inputIds\":[\"$INPUT_ID\"],\"options\":$OPTIONS,\"maxCredits\":1}"

4. 取得結果

curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY"

每隔 1–2 秒重複最後一個請求，直到 status 變為 completed。將 DOWNLOAD_PATH 設為已完成檔案的 outputs[].downloadUrl，再使用以下指令下載。

curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
  -H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webp

點數價格

操作	費用
圖片壓縮或格式轉換	每張圖片的每種輸出格式 1 點
圖片轉 PDF	每張來源圖片 1 點，合併或分別輸出皆相同
PDF 壓縮	每頁來源 PDF 1 點，頁數由伺服器核實

10 張圖片轉為 WebP 和 AVIF 共需 20 點；10 張圖片合成一個 PDF 需 10 點；壓縮 30 頁 PDF 需 30 點。

上傳、報價、餘額與狀態查詢、預覽、下載和 ZIP 皆免費。無須訂閱；所有帳戶的價格與限制相同。

點數在處理開始時扣除。maxCredits 設定支出上限。批次處理前，先透過 quote 查看總費用，再呼叫 start。重試時使用相同任務、ID 和參數，以免支付新任務的費用。

每個檔案最多 50,000,000 位元組，每個任務最多 250 個來源檔案。草稿與結果保留 2 小時；請檢查 expiresAt 並及時下載。網站配額不適用於 API/MCP。