Standard-Workflow für MCP-Generierung

Verfügbarkeit prüfen

Das offizielle MCP ist unter https://api.animgen.com/mcp als öffentliche Beta verfügbar. Schließe die Client-Einrichtung mit OAuth und verifiziertem Konto ab. Verbindung oder Modellabfrage genehmigen keine bezahlte Generierung.

1. Modelle abfragen

Für Auswahl anhand einer Vorschau, FPS-Änderung oder Quellwiederverwendung folge dem gestuften Auswahl-/FPS-Workflow: quote_video_generation → generate_video → get_video_generation → preview_video → quote_animation_export → export_animation → get_animation_export. Genehmige jede bezahlte Erstellung separat und verwende die Video-Asset-ID für weitere Exporte. Der Ein-Aufruf-Workflow mit Frame-Anzahl folgt unten.

Rufe list_models mit leerem Argumentobjekt auf. Wähle eine tatsächlich zurückgegebene Modell-ID samt unterstützten Einstellungen. Nicht alle Modelle akzeptieren Endbilder, Referenzen, Negativ-Prompts, Seeds oder gleiche Dauer/Seitenverhältnisse.

2. Ein lokales Bild übertragen

Ein lokaler Pfad ist kein ImageInput. Die Uploadbrücke hat drei getrennte Schritte:

1. Rufe prepare_image_upload mit filename, mime_type und exakter byte_size auf.
2. Sende vor expires_at tatsächliche Bytes mit zurückgegebenen HTTP-method, upload_url und headers. Eine autorisierte Client-Fähigkeit führt die Übertragung aus; ein Pfad an MCP genügt nicht.
3. Rufe complete_image_upload mit upload_id auf. Nutze die zurückgegebene file_id zur Generierung.

Sende MCP-Token oder API-Schlüssel nicht an das Uploadziel. Nutze nur die zurückgegebenen Upload-Header und behandle URLs vertraulich. Kann der Client keine Bytes übertragen, nutze eine unterstützte freigegebene Client-Funktion, eine erlaubte öffentliche HTTPS-Bildeingabe oder Base64 innerhalb der Bildlimits. Behaupte keinen erfolgreichen Upload.

3. Anfrage aufbauen und kalkulieren

Dies ist die Argumentform für quote_animation. Ersetze die Platzhalter-UUID durch die file_id eines abgeschlossenen Uploads. Setze für eine echte Anfrage Modell und gültige Optionen.

{
  "request": {
    "input": {
      "first_frame": {
        "type": "file",
        "file_id": "00000000-0000-4000-8000-000000000001"
      }
    },
    "prompt": "A character runs in place, side view, fixed camera.",
    "selection": {"mode": "full"},
    "export": {
      "output_formats": ["frames_zip"],
      "frame_count": 24,
      "output_width": 512,
      "output_height": 512
    }
  }
}

Das Ergebnis enthält quote_id, credits, breakdown und expires_at. Kalkulation startet keine Generierung. Erkläre Ausgabe und Kosten und hole Zustimmung ein.

4. Nur nach Freigabe generieren

Rufe generate_animation mit derselben request, gespeichertem idempotency_key und freigegebener quote_id und/oder max_credits auf. Diese drei Felder sind Tool-Argumente neben request, nicht darin.

Nutze bei Bedarf aktuelle Kalkulation und Maximum gemeinsam. Das Maximum muss vom Nutzer genehmigt sein, nicht von der KI erfunden. Lies vor Wiederholungslogik den Ausgabenschutz.

Speichere die Auftrags-ID. Ein zurückgegebener Auftrag ist asynchron und noch kein abgeschlossener Download.

5. Bis zum Endzustand abfragen

Rufe get_animation mit animation_id auf. Nutze begrenzte Intervalle, anfangs etwa fünf Sekunden, und eine Frist. Ergebnisse sind strukturiertes JSON; setze nicht voraus, dass MCP den HTTP-Header Retry-After der API verfügbar macht.

Frage bei queued, running oder cancelling weiter ab und stoppe bei succeeded, failed oder cancelled. Prüfe auch nach Fehlern outputs: Bei Exportfehler kann ein Quellvideo existieren.

6. Tatsächliche Bytes herunterladen

Rufe für jedes nutzbare Asset download_asset mit asset_id auf. Das liefert Metadaten und signierte URL, speichert aber nicht automatisch eine lokale Datei.

Nutze eine erlaubte Client-Downloadfunktion ohne OAuth-/API-Zugangsdaten weiterzugeben. Speichere privat und nenne lokalen Speicherort oder einen passenden Anhang statt roher signierter URL. Erneuere bei Ablauf mit download_asset.

Nutze für Abbruch cancel_animation mit animation_id und frage danach weiter ab. Abbruch erfolgt nach bestem Bemühen und bedeutet keine vollständige Erstattung.