Dies ist eine Übersetzung, die aus Gründen der Bequemlichkeit bereitgestellt wird. Die maßgebliche technische Referenz ist die englische Fassung; im Falle von Abweichungen hat der englische Text Vorrang.
Authentifizierung
Jede Anfrage benötigt einen API-Schlüssel, der als einer der beiden Header gesendet wird:
Erstelle einen Schlüssel im API-Schlüssel-Bereich deines Dashboards. Der Klartext-Schlüssel wird genau einmal angezeigt, bei der Erstellung — wenn du ihn verlierst, widerrufe ihn und erstelle einen neuen. Du kannst bis zu 10 aktive Schlüssel gleichzeitig haben; alle teilen sich ein Credit-Guthaben.
Credits & Preise
Jede Datei kostet 1 Credit pro Sekunde verarbeiteter Dauer, mindestens 3 Credits — ein 2-Sekunden-Clip kostet trotzdem den 3-Credit-Mindestbetrag, ein 10-Sekunden-Clip kostet 10. Credits werden bei der Einreichung des Auftrags abgezogen (bevor die Verarbeitung beginnt), basierend auf der Dauer der Datei selbst, nicht auf einer pauschalen Pro-Datei-Rate. Eine Batch-Anfrage berechnet jede Datei im Batch im Voraus — wenn dein Guthaben nicht den gesamten Batch abdeckt, wird nichts davon erstellt. Wenn sich eine Datei als nicht lesbar herausstellt, wird der Credit dieser Datei automatisch erstattet.
| Plan | Credits | Preis |
|---|---|---|
| Credit-Paket — Micro | 15 (verfallen nie) | $1.99 |
| Credit-Paket — Light | 150 (verfallen nie) | $9.99 |
| Credit-Paket — Heavy | 900 (verfallen nie) | $39.99 |
| Plus Vierteljährlich | 2.700 / Quartal | 79,99 $/Quartal |
| Pro Monatlich | 3.000 / Monat | 79,99 $/Monat |
| Pro Jährlich | 36.000 / Jahr | 799,99 $/Jahr |
Credits liegen auf deinem Konto, nicht auf einem einzelnen Schlüssel — jeder Schlüssel, den du erstellst, schöpft aus demselben Pool. Prüfe dein Guthaben jederzeit mit GET /api/account (Dashboard-Sitzungs-Authentifizierung, nicht API-Schlüssel-Authentifizierung).
Datei einreichen — POST /api/v1/jobs
Multipart-Formulardaten:
| Feld | Werte | Hinweise |
|---|---|---|
file | erforderlich | .gif, .mp4, .mov, .webm |
method | auto (Standard) · fast · rembg | fast verwendet Flood-Fill statt KI-Segmentierung — schneller, funktioniert am besten bei einfarbigen Hintergründen |
tolerance | 8–32 (Standard 16) | nur von method=fast verwendet |
crop | true (Standard) · false | automatischer Zuschnitt auf den Begrenzungsrahmen des Motivs |
pad | 0–50 px (Standard 12) | um den Zuschnitt herum beibehaltener Abstand |
canvasW / canvasH | px | Ausgabe-Canvasgröße; weglassen, um die Originalgröße beizubehalten |
anchor | center (Standard) · bottom | Platzierung des Motivs beim Skalieren auf einen Canvas |
outputFormat | gif (Standard) · apng · webm · mp4 | siehe Hinweis unten zu mp4 |
bgColor | transparent (Standard) · #rrggbb | erforderlich für mp4 |
trim | true · false (Standard) | schneidet automatisch untätige Anfangs-/End-Frames zu — nur GIF-Quellen |
Die mp4-Ausgabe hat keinen Alphakanal, ergibt also nur mit einem soliden bgColor Sinn — mp4 mit transparentem Hintergrund anzufordern fällt automatisch auf gif zurück.
Antwort 202:
Status abfragen — GET /api/v1/jobs/:id
previewUrl erscheint, sobald eine Vorschau verfügbar ist; downloadUrl erst, wenn status done ist. Ein Auftrag ist nur für den API-Schlüssel sichtbar, der ihn erstellt hat — jeder andere Schlüssel erhält einen 404.
Vorschau & Download
GET /api/v1/jobs/:id/preview und GET /api/v1/jobs/:id/download streamen die Datei direkt, authentifiziert auf dieselbe Weise wie jeder andere Aufruf — kein separater Download-Token.
Batches — POST /api/v1/batches
Dieselben Felder wie POST /api/v1/jobs, aber wiederhole das Feld file einmal pro Datei (bis zu 20 Dateien pro Anfrage). Ein Optionssatz gilt für jede Datei im Batch.
GET /api/v1/batches/:id gibt { "id", "status": "processing | partial | done", "jobs": [...] } zurück, wobei jeder Eintrag dieselbe Form wie GET /api/v1/jobs/:id hat.
Fehler
| Status | Body | Bedeutung |
|---|---|---|
401 | { "error": "unauthorized" } | fehlender, ungültiger oder widerrufener API-Schlüssel |
402 | { "error": "insufficient_credits", "creditsRemaining" } | nicht genügend Credits — es wurde kein Auftrag erstellt |
400 | { "error": "bad_request" } | keine gültige Datei oder fehlerhafter Multipart-Body |
422 | { "error": "unreadable_file" } | Datei konnte nicht geparst werden — kein Credit berechnet |
404 | { "error": "not_found" } | Auftrag/Batch existiert nicht oder gehört zu einem anderen Schlüssel |
429 | { "error": "rate_limited" } | zu viele Anfragen — siehe Retry-After-Header |
Ratenbegrenzungen
Anfragen sind pro API-Schlüssel ratenbegrenzt. Wenn du ratenbegrenzt bist, enthält die Antwort einen Retry-After-Header (Sekunden) — warte so lange, bevor du es erneut versuchst. Brauchst du ein höheres Limit für eine Produktionsintegration? Melde dich über dein Dashboard.