MEDIA_QUOTA_EXCEEDED

MEDIA_QUOTA_EXCEEDED

Deine Media-Library ist voll. Sobald du ein neues Asset (Bild, Sound, kurzes Video, GIF) hochlädst oder ein AI-generiertes Bild speicherst, lehnt der Server den Upload mit MEDIA_QUOTA_EXCEEDED ab. Die Aktion wird nicht halb durchgeführt — kein Teil-Upload, keine Credits werden für AI-Bilder verbrannt.

Wie groß ist die Quota?

Die Quota hängt am Plan deines Workspaces. Den aktuellen Stand fragst du am sichersten so ab:

GET /v1/plan/

Die Antwort enthält unter anderem:

{
  "plan": "free",
  "media_quota_bytes": 524288000,
  "media_used_bytes": 521943212,
  "...": "..."
}

Im Dashboard siehst du dasselbe als Fortschrittsbalken unter /dashboard/media. Bei ≥ 95% wird der Balken rot.

Als Richtwert (kann sich verschieben — der /v1/plan/-Response ist die Wahrheit):

• Free: ca. 500 MB
• Pro / Höhere Pläne: deutlich mehr, Details im Plan-Endpoint

Sofort-Lösungen

1. Aufräumen im Dashboard

/dashboard/media öffnen. Es gibt Filter:

• « Nicht verwendet » — Assets, die in keiner Alert-Vorlage, Overlay-Szene, AI-Bild-Historie oder Sound-Pack mehr referenziert werden. Das sind die ehrlichsten Kandidaten zum Löschen.
• « Groß » — Sortierung nach Dateigröße, hilft bei dem einen vergessenen 80 MB MP4.
• « Alt » — Sortierung nach Erstellungsdatum.

Mehrfach-Auswahl per Häkchen, dann « Auswahl löschen ». Der Löschvorgang ist final (keine Tonne), Quota wird sofort wieder freigegeben.

2. Plan upgraden

Unter /dashboard/billing Plan wechseln. Die neue Quota greift sofort, der MEDIA_QUOTA_EXCEEDED verschwindet beim nächsten Upload.

3. Externe Hosting-URL nutzen

Für einzelne große Assets, die du eh anderswo liegen hast (z.B. CDN, Twitch-Asset, eigener S3-Bucket), kannst du in einigen Komponenten direkt eine URL eintragen statt einen Upload auszulösen. Achtung: Chatlix kann externe Quellen nicht garantieren — wenn die Datei woanders weg ist, ist sie auch im Overlay weg.

Warum AI-Bilder die Quota schnell füllen

Die ai_image_generate-Action speichert jedes erfolgreiche Bild automatisch in der Media Library. Pro Bild typisch 1–3 MB. Wer in einer Stream-Session 30 Bilder generiert, hat schnell 60–90 MB drauf. Tipps:

• Im AI-Bild-Dialog « Verwerfen » nutzen, wenn ein Bild nicht gut ist — dann landet es nicht in der Library.
• Regelmäßig den AI-Filter in der Media Library aufmachen und alte Generationen löschen.

Diagnose, wenn der Balken "voll" anzeigt, du aber wenig drin hast

• Versteckte Asset-Typen: TTS-Cache-Snippets (kurze MP3s) zählen je nach Setup mit. Filter « Audio » zeigt sie.
• Sound-Pack-Importe: Importierte Pack-Sounds zählen pro Workspace nur einmal — aber wenn du dasselbe Pack in zwei Workspaces nutzt, sind es zwei Zählungen.
• Workspace-Auswahl prüfen: Die Quota ist pro Workspace. Wenn du in zwei Workspaces arbeitest, kann der eine voll und der andere leer sein.

Verwandte Fehler

• MEDIA_TOO_LARGE — Einzeldatei überschreitet das Upload-Limit (unabhängig von Quota).
• MEDIA_FORMAT_UNSUPPORTED — Dateiformat nicht erlaubt (z.B. .exe).
• MEDIA_VIRUS_DETECTED — Scan-Stage hat angeschlagen, Upload wird verworfen.