コンテンツへスキップ
記事

API:クイックスタート

REST APIで画像やPDFの処理を自動化します。

アクセスとキー

Levomioにログインし、設定でキーを作成します。コピーして、使用するクライアントのYOUR_API_KEYを置き換えてください。キーは公開しないでください。

キーを管理 · API

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"

statusがcompletedになるまで、最後のリクエストを1~2秒ごとに繰り返します。完成したファイルのoutputs[].downloadUrlをDOWNLOAD_PATHに設定し、次のコマンドでダウンロードします。

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

クレジット料金

操作料金
画像の圧縮・変換画像と出力形式の組み合わせごとに1クレジット
画像からPDF結合・個別出力にかかわらず元画像1枚につき1クレジット
PDF圧縮元PDFの1ページにつき1クレジット。ページ数はサーバーが確認

画像10枚をWebPとAVIFにすると20クレジット、10枚を1つのPDFにすると10クレジット、30ページのPDF圧縮は30クレジットです。

アップロード、見積もり、残高・状態確認、プレビュー、ダウンロード、ZIPは無料です。サブスクリプションは不要で、料金と上限は全アカウント共通です。

クレジットは処理開始時に消費されます。maxCreditsは消費の上限です。複数ファイルの場合はstartの前にquoteで合計を確認してください。再試行は同じタスク、ID、パラメータで行い、新規タスクの料金が発生しないようにします。

1ファイル50,000,000バイト、1タスク250件の入力まで。下書きと結果の保存期間は2時間です。expiresAtを確認し、期限内にダウンロードしてください。ウェブサイトの利用枠はAPI/MCPには適用されません。