Fehler

Fehlschläge von Aufträgen erscheinen bei get_status als failed, nicht als MCP-Protokollfehler. Dass create_video mit einer jobId erfolgreich ist, ist normal.

Code	Bedeutung
`UNAUTHORIZED`	OAuth fehlt oder ist ungültig
`PLAN_REQUIRED`	Ein Kostenlos-Tarif hat den Video MCP aufgerufen
`FORBIDDEN`	Kein Mitglied des Workspace
`NOT_FOUND`	Projekt, Auftrag oder Datei nicht gefunden
`CREDITS_EXHAUSTED`	Der Inhaber hat keine Credits, um diesen Auftrag zu starten. Der Fehler enthält eine `topUpUrl`
`RECIPE_REQUIRES_FOOTAGE`	`edit` ohne Video-Datei
`RECIPE_REQUIRES_BRIEF`	Leeres Briefing
`ASSET_NOT_READY`	Upload wird noch verarbeitet — `create_video` erneut versuchen
`JOB_STILL_RUNNING`	Ein Auftrag läuft noch: ein anderer Auftrag im Projekt oder (bei `export_video`) dieser Auftrag
`JOB_FAILED`	`export_video` bei einem fehlgeschlagenen Auftrag: Es gibt kein Video zum Exportieren. Die Meldung enthält den Fehler des Auftrags
`JOB_CANCELLED`	`export_video` bei einem abgebrochenen Auftrag
`UPLOAD_REQUIRED`	`style_reference_url` ist ein Instagram-, X- oder TikTok-Link, den Fluos nie abruft
`INVALID_ARGUMENT`	Ein Argument hat die falsche Form, zum Beispiel eine `style_reference_url`, die weder ein YouTube-Link noch eine direkte Videodatei ist
`TEMPLATES_DISABLED`	Vorlagen sind gerade nicht verfügbar
`UNLICENSED_SOURCES`	`export_video` mit `require_licensed: true`, obwohl bei einer Quelle die Rechte nicht verifiziert sind
`GENERATION_FAILED`	Die Generierung von Clip oder Bild ist nach mehreren Versuchen fehlgeschlagen
`COMPOSE_FAILED`	Erstellung oder Validierung fehlgeschlagen
`EXPORT_FAILED`	Rendering fehlgeschlagen
`RATE_LIMITED`	Warte, bevor du es erneut versuchst; `Retry-After` kann vorhanden sein

Was der Agent tun soll

UNAUTHORIZED — schließe den OAuth-Login im Browser ab und versuche es dann erneut. Siehe OAuth und Zugriff.
PLAN_REQUIRED oder CREDITS_EXHAUSTED — halte an und zeige die Abrechnungs-URL. Versuche es nicht erneut.
awaiting_credits bei get_status — kein Fehler. Die Erstellung ist pausiert. Zeige dem Nutzer pause.topUpUrl und frage etwa einmal pro Minute weiter ab; derselbe Auftrag läuft nach dem Aufladen von selbst weiter. Siehe Pausierte Aufträge.
UPLOAD_REQUIRED — bitte den Nutzer, das Video mit upload_asset hochzuladen, und übergib dann dessen assetId.
UNLICENSED_SOURCES — ersetze die in der Meldung aufgeführten nicht verifizierten Dateien oder exportiere ohne require_licensed.
JOB_STILL_RUNNING — frage get_status ab oder nutze cancel_job.
ASSET_NOT_READY — es wurde nichts erstellt. notReadyAssetIds listet die Dateien auf, die noch nicht nutzbar sind (notReadyAssets[].reason: processing, failed oder missing_file). Rufe bei processing list_assets auf, bis der processingStatus jeder Datei ready ist (oder warte retryAfterSeconds), und versuche es dann mit denselben Argumenten erneut; lade Dateien mit failed oder missing_file neu hoch.
JOB_FAILED oder JOB_CANCELLED (bei export_video) — überarbeite das Video mit revise_video auf dieser jobId und exportiere es, sobald es fertig ist.
RECIPE_REQUIRES_FOOTAGE — lade eine Video-Datei hoch oder wechsle zu generate / compose.
Behebbare Compose-Fehler — nutze revise_video mit der Fehlermeldung.

Verbindungsprobleme (der Server erscheint nie, OAuth-Schleife) werden auf der Seite des jeweiligen Agenten und in der Fehlerbehebung behandelt.

Was der Agent tun soll

Auf dieser Seite