API:クイックスタート
REST APIで画像やPDFの処理を自動化します。
アクセスとキー
Levomioにログインし、設定でキーを作成します。コピーして、使用するクライアントのYOUR_API_KEYを置き換えてください。キーは公開しないでください。
キーを管理 · APIAPI:クイックスタート
この例では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には適用されません。