API: Schnellstart
Automatisiere die Bild- und PDF-Verarbeitung mit der REST-API.
Zugang und Schlüssel
Melde dich bei Levomio an und erstelle einen Schlüssel in den Einstellungen. Kopiere ihn und ersetze YOUR_API_KEY in deinem Client. Halte den Schlüssel geheim.
Schlüssel verwalten · APIAPI: Schnellstart
Das Beispiel konvertiert photo.png für 1 Credit zu WebP. Setze LEVOMIO_API_KEY auf deinen Schlüssel und führe die Befehle im selben Terminal aus. Du benötigst Bash, curl und uuidgen.
1. Aufgabe erstellen
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. Bild hochladen
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. Starten — höchstens 1 Credit
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. Ergebnis abrufen
curl --fail-with-body "$LEVOMIO_ORIGIN/api/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $LEVOMIO_API_KEY"Wiederhole die letzte Anfrage alle 1–2 Sekunden, bis status completed ist. Setze DOWNLOAD_PATH auf outputs[].downloadUrl der fertigen Datei und lade sie mit diesem Befehl herunter.
curl --fail-with-body "$LEVOMIO_ORIGIN$DOWNLOAD_PATH" \
-H "Authorization: Bearer $LEVOMIO_API_KEY" --output result.webpPreise in Credits
| Vorgang | Kosten |
|---|---|
| Bildkomprimierung oder -konvertierung | 1 Credit pro Bild und Ausgabeformat |
| Bilder zu PDF | 1 Credit pro Quellbild, zusammengeführt oder einzeln |
| PDF-Komprimierung | 1 Credit pro Quell-PDF-Seite; der Server zählt die Seiten |
10 Bilder zu WebP und AVIF kosten 20 Credits; 10 Bilder in einer PDF kosten 10; die Komprimierung einer PDF mit 30 Seiten kostet 30.
Uploads, Kostenvoranschläge, Guthaben- und Statusabfragen, Vorschauen, Downloads und ZIP sind kostenlos. Kein Abonnement erforderlich; Preise und Limits gelten für alle Konten gleichermaßen.
Credits werden beim Start abgebucht. maxCredits begrenzt die Ausgaben. Für Stapel frage vor start den Gesamtpreis mit quote ab. Wiederhole dieselbe Aufgabe mit denselben IDs und Parametern, statt eine neue kostenpflichtige Aufgabe anzulegen.
50.000.000 Bytes pro Datei, 250 Quelldateien pro Aufgabe. Entwürfe und Ergebnisse bleiben 2 Stunden gespeichert; beachte expiresAt und lade rechtzeitig herunter. Website-Kontingente gelten nicht für API/MCP.