Direkt zum Hauptinhalt

MEDIA_QUOTA_EXCEEDED

Deine Media-Library ist voll, oder die Datei, die du gerade hochlädst, überschreitet das Größenlimit deines Plans. Der Server lehnt den Upload dann komplett ab — kein Teil-Upload, keine AI-Credits werden verbrannt.

Die tatsächlichen Limits pro Plan

Zuständig ist MediaQuotaService. Es gibt zwei getrennte Grenzen: Gesamtspeicher (media_storage_bytes) und maximale Dateigröße pro Upload (media_max_upload_bytes). Die Werte aus dem aktuellen Code:

  • Free: 100 MB Gesamtspeicher, max. 5 MB pro Datei. Video-Uploads sind auf Free komplett gesperrt (Fehlercode free_video_blocked).
  • Starter: 1 GB Gesamtspeicher, max. 10 MB pro Datei.
  • Pro: 5 GB Gesamtspeicher, max. 20 MB pro Datei.
  • Creator: 5 GB Gesamtspeicher, max. 30 MB pro Datei.
  • Elite: 50 GB Gesamtspeicher, max. 50 MB pro Datei.
  • Pro Max: 20 GB Gesamtspeicher, max. 100 MB pro Datei.
  • Team / Studio: 100 GB Gesamtspeicher, max. 200 MB pro Datei.

Wichtig: Der Free-Plan liegt real bei 100 MB, nicht bei 500 MB — falls du das aus älteren Screenshots oder Foren-Posts im Kopf hast, das war entweder ein anderer Plan-Stand oder ein Missverständnis. Verlass dich im Zweifel immer auf die Live-Werte aus dem Plan-Endpoint, nicht auf feste Zahlen irgendwo im Netz.

Die tatsächlichen Fehlercodes

  • free_video_blocked — Video-MIME-Type auf Free-Plan generell nicht erlaubt, unabhängig von der Größe.
  • upload_too_large / free_upload_too_large — die einzelne Datei überschreitet media_max_upload_bytes deines Plans.
  • storage_full / free_storage_full — dein bisheriger Verbrauch plus die neue Datei würde media_storage_bytes überschreiten.

Jeder dieser Codes kommt mit einer fertigen deutschen message_de und — nur auf Free — einem upgrade_hint_de, die im Dashboard 1:1 angezeigt werden. Der Verbrauch selbst wird live aus der Summe deiner chatlix_media-Einträge berechnet (abzüglich soft-gelöschter Dateien), nicht aus einem Cache.

Aktuellen Stand abfragen

GET /v1/storage/me

{
  "plan": "free",
  "used_bytes": 102943212,
  "limit_bytes": 104857600,
  "remaining_bytes": 1914388,
  "max_upload_bytes": 5242880,
  "videos_allowed": false,
  "ai_images_per_day": 0
}

Im Dashboard siehst du dasselbe als Fortschrittsbalken unter /dashboard/media, ab ca. 95% wird er rot.

Sofort-Lösungen

  1. Unter /dashboard/media nach Größe sortieren, alte/ungenutzte Assets löschen (alte AI-Bilder, Test-Sounds, ersetzte Alert-Videos sind die üblichen Verdächtigen).
  2. Video-Dateien komprimieren, bevor du sie hochlädst — gerade auf Free/Starter reicht 5–10 MB oft nicht für unkomprimierte Clips.
  3. Plan upgraden, wenn du strukturell mehr Speicher brauchst — insbesondere für Clip-Studio-Nutzung, wo VODs und gerenderte Shorts denselben Media-Pool belegen (siehe VOD importieren + verarbeiten lassen).

Hinweis für Clip-Studio-Nutzer

VODs und Shorts aus Clip Studio zählen mit demselben MediaQuotaService gegen deine Quota wie normale Media-Uploads. Wenn ein VOD-Import mit storage_full abbricht, ist das exakt derselbe Mechanismus wie hier beschrieben — die Lösung ist identisch: aufräumen oder upgraden.