Zum Inhalt springen
Artikel

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 · API

API: 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.webp

Preise in Credits

VorgangKosten
Bildkomprimierung oder -konvertierung1 Credit pro Bild und Ausgabeformat
Bilder zu PDF1 Credit pro Quellbild, zusammengeführt oder einzeln
PDF-Komprimierung1 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.