API-Schnellstart: vom Bild zu heruntergeladenen Assets

Voraussetzungen

Die öffentliche API ist in öffentlicher Beta. Du brauchst ein verifiziertes AnimGen-Konto, einen API-Schlüssel mit animations:read und animations:write sowie einen vertrauenswürdigen Server oder lokalen Rechner. Generierung benötigt genügend Credits; Abonnements erhöhen Entwicklerlimits, sind aber keine Zugangsvoraussetzung.

Erstelle einen Schlüssel unter Konto → Entwickler. Stelle ihn über deinen Geheimnisspeicher oder eine private Shell als Umgebungsvariable ANIMGEN_API_KEY bereit. Nie in Browser-JavaScript, ausgelieferten Spielen, Repositories oder KI-Chats speichern.

Die Basis-URL lautet https://api.animgen.com/v1. URL-Kompatibilitätsversion ist v1, dokumentierte Schemaversion 1.4.0.

1. Ein unterstütztes Modell abfragen

curl --fail-with-body https://api.animgen.com/v1/models \
  -H "Authorization: Bearer $ANIMGEN_API_KEY"

Wähle eine id aus data, die deinen Eingabemodus unterstützt. Prüfe Dauer, Auflösungen, Seitenverhältnisse und Funktionsflags. Kopiere keinen Modellnamen aus einem alten Artikel.

Für das folgende Startbildbeispiel verwende ein Modell mit supports_first_frame: true und entsprechender Unterstützung in modes. Das Beispiel nutzt seine veröffentlichten Standardoptionen.

2. Vorbereiten und kalkulieren, ohne zu generieren

Lade das Python-Workflow-Beispiel herunter und prüfe es. Es benötigt Python 3.10+ und nur die Standardbibliothek.

curl --fail-with-body -o animation-workflow.py \
  https://animgen.com/examples/animation-workflow.py

python3 animation-workflow.py prepare \
  --image character.png \
  --model 'PROVIDER:MODEL_FROM_CATALOG' \
  --prompt 'A character runs in place, side view, fixed camera.' \
  --state hero-run.json

Ersetze Bildpfad und Modell-ID. Die Vorbereitung prüft den Katalog, erstellt eine Inline-Base64-Anfrage, liest Kosten und Guthaben und speichert einen privaten Zustand. Sie ruft den kostenpflichtigen Erstellungsendpunkt nicht auf.

Die Zustandsdatei enthält Bild und Prompt. Halte sie außerhalb der Versionskontrolle, beschränke Zugriff und entferne sie, wenn nicht mehr nötig. Sie enthält keinen API-Schlüssel.

3. Erstellung ausdrücklich freigeben

Prüfe die Credits und setze APPROVED_CREDITS auf den akzeptierten Betrag. Führe dann aus:

python3 animation-workflow.py run \
  --state hero-run.json \
  --approve-credits "$APPROVED_CREDITS" \
  --output ./hero-output

Das Skript kalkuliert vor der ersten Erstellung erneut, lehnt einen höheren Preis als deine lokale Freigabe ab, speichert einen Idempotenzschlüssel und reicht die unveränderte Anfrage logisch einmal ein. Danach fragt es Status ab und lädt verfügbare Ausgaben herunter.

4. Sicher fortsetzen und Ergebnis prüfen

Bei Timeout führe denselben Befehl mit derselben Zustandsdatei erneut aus. Ist eine Auftrags-ID gespeichert, setzt es Statusabfragen statt Erstellung fort. Bei unklarer Erstellungsantwort verwendet es Schlüssel und Nutzdaten innerhalb seines konservativen Wiederholungsfensters erneut.

Lösche die Zustandsdatei nicht zum „Wiederholen“. Das erzeugt eine neue logische Operation und kann doppelt kosten. Das Beispiel verweigert ungeklärte Erstellungswiederholungen nach 24 Stunden; prüfe zuerst Auftragsliste oder Support.

Bei jedem Endzustand speichert das Skript verfügbare Assets vor der Fehler-/Abbruchmeldung. Unvollständige Ergebnisse führen zu einem von null verschiedenen Exit-Code; Teilexporte zählen nie als voller Erfolg. Dateinamen verwenden Asset-IDs statt vom entfernten Server vorgegebener Namen.

Was die Anfrage macht

Das Beispiel fordert eine normale Animation über die volle Länge mit PNG-Frames-ZIP, 24 Frames und 512 × 512 Ausgabe an. Das sind Beispielentscheidungen, keine API-Standards oder universelle Qualitätsempfehlung.

Für wiederverwendbare Uploads oder öffentliche URLs siehe Authentifizierung und Bildeingaben. Für Lebenszyklus siehe Statusabfragen und Downloads sowie Fehler und Wiederholungen. Der genaue Vertrag steht im OpenAPI-JSON.

Das Python-Beispiel wird mit einem lokalen Mock getestet, nicht durch bezahlte Produktionsgenerierung. Prüfe deine Integration mit einem kleinen ausdrücklich freigegebenen Auftrag. Weitere Sprachen und ihr Prüfungsumfang stehen unter ausführbare Beispiele, genaue Parameter in der API-Referenz.