keyer — KI-Videohintergrundentfernung
Entfernt den Hintergrund aus jedem Frame eines Videos mittels BiRefNet-general (ein hochwertiges Matting-Modell via rembg). Optional Compositing auf eine Volltonfarbe oder ein Hintergrundbild. Der Ton bleibt erhalten.
Das Skill-Verzeichnis (in dem diese SKILL.md liegt) wird nachfolgend als $SKILL_DIR bezeichnet.
GPU erforderlich. Benötigt eine CUDA-GPU mit ≥ 3 GB freiem VRAM. Wenn der LLM-Kontext VRAM belegt, pausieren Sie ihn vor der Ausführung.
Wann verwenden
Verwenden Sie dieses Skill, wenn der Benutzer Folgendes wünscht:
- Entfernen des Hintergrunds aus einem Video (Talking Head, Produktdemo usw.)
- Platzieren eines Motivs auf einer Volltonfarbe oder einem Markenhintergrund
- Exportieren eines Videos mit transparentem Hintergrund (Alpha-Kanal-PNG-Frames)
Einrichtung (nur beim ersten Mal)
cd "$SKILL_DIR" && uv sync
Die BiRefNet-Modellgewichte werden beim ersten Start automatisch heruntergeladen (~500 MB).
Agenten-Workflow
1. Den Benutzer fragen
Bevor ich den Hintergrund entferne, benötige ich folgende Angaben:
🎭 Hintergrundersatz
- null — transparenten Alphakanal behalten (PNG-Frames; kein alpha im mp4)
- #hex-Farbe — z. B. "#1a1a2e" für dunkles Marineblau
- /pfad/zum/bg — Compositing auf eine Bilddatei
🧠 Modell
- birefnet-general — beste allgemeine Qualität [Standard]
- birefnet-portrait — optimiert für Personen
- isnet-general-use — schnellere Alternative
- u2net_human_seg — schnell, nur Menschen
📁 Eingabe-/Ausgabeverzeichnisse (Standard: ./input und ./output)
Warten Sie auf die Antwort des Benutzers, bevor Sie fortfahren.
2. config.json bearbeiten
Schreiben oder aktualisieren Sie $SKILL_DIR/config.json basierend auf den Benutzerentscheidungen.
3. Ausführen
cd "$SKILL_DIR" && uv run python scripts/matte.py --config config.json
4. Ergebnisse melden
Teilen Sie dem Benutzer die Pfade der Ausgabedateien und den verwendeten Hintergrundmodus mit.
Konfigurationsreferenz
| Schlüssel | Werte | Standard | Beschreibung |
|---|---|---|---|
input_dir | Pfad | ./input | Ordner mit Eingabevideos |
output_dir | Pfad | ./output | Zielordner |
model | siehe oben | birefnet-general | Matting-Modell |
bg | null / hex / Pfad | null | Hintergrundersatz |
Häufige Aufrufe
# Standard: Hintergrund entfernen, transparente Ausgabe
cd "$SKILL_DIR" && uv run python scripts/matte.py
# Compositing auf dunklen Hintergrund
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg "#0d0d0d"
# Compositing auf ein Bild
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg /pfad/zum/studio_bg.jpg
# Portrait-optimiertes Modell
cd "$SKILL_DIR" && uv run python scripts/matte.py --model birefnet-portrait
# Null-Hintergrund (als Zeichenkette "null" über CLI übergeben)
cd "$SKILL_DIR" && uv run python scripts/matte.py --bg null
Ausgabe
Jedes Eingabevideo erzeugt eine Ausgabe-.mp4 im output_dir mit demselben
Dateinamen. Wenn bg=null, wird die Ausgabe mit yuv420p codiert (keine echte Transparenz
im mp4); für echte transparente Frames führen Sie clawimig aus oder exportieren Sie als PNG-Sequenz.
Fehlerbehandlung
- Nicht ausreichend VRAM → gibt erforderliche vs. verfügbare GB aus, Tipps zum Freigeben von VRAM, beendet sich
- Keine CUDA-GPU / ONNX CUDAExecutionProvider fehlt → klare Fehlermeldung, beendet sich
- Keine Videos im input_dir → saubere Meldung, beendet sich
- Fehler bei einzelnen Videos → werden protokolliert; andere Videos werden weiterverarbeitet