liven — Bild zu Video (Cloud)
Erweckt Standbilder mit dem LTX-2.3 Fast Video-Diffusionsmodell auf der Cloud-Infrastruktur von fal.ai zum Leben. Geben Sie ein Bild und einen Bewegungs-Prompt an; das Modell generiert einen kurzen Videoclip (6-20 Sekunden, je nach Einstellung).
Das Skill-Verzeichnis (in dem diese SKILL.md liegt) wird im Folgenden als $SKILL_DIR bezeichnet.
Cloud-basiert. Keine lokale GPU erforderlich. Erfordert die Umgebungsvariable
FAL_API_KEY. Preise: $0,04/s für 1080p, $0,08/s für 1440p, $0,16/s für 4K.
Wann verwenden
Verwenden Sie diesen Skill, wenn der Benutzer Folgendes möchte:
- Ein Foto oder eine Illustration ohne lokale GPU animieren
- Filmische Bewegungen aus einem Standbild erzeugen (z. B. langsamer Zoom, Schwenk, Lichtflackern)
- Social-Media-Videoinhalte aus Produktaufnahmen oder Porträts erstellen
- Höhere Auflösungen (bis zu 4K) ohne lokale VRAM-Beschränkungen nutzen
Einrichtung (nur beim ersten Mal)
cd "$SKILL_DIR" && uv sync
Setzen Sie die Umgebungsvariable FAL_API_KEY:
export FAL_API_KEY="Ihr-API-Schlüssel-hier"
Agenten-Workflow
1. Fragen Sie den Benutzer
Bevor ich das Bild animiere, benötige ich folgende Informationen:
💬 Bewegungs-Prompt (erforderlich)
Beschreiben Sie die gewünschte Bewegung, z. B.:
"langsamer filmischer Push-In, goldenes Stundenlicht, subtile Kameradrift"
🎬 Clip-Einstellungen
- duration — Videolänge in Sekunden (Standard: 6, Optionen: 6, 8, 10, 12, 14, 16, 18, 20)
Hinweis: Dauern >10s unterstützen nur 25 FPS und 1080p
- resolution — Ausgabequalität (Standard: 1080p, Optionen: 1080p, 1440p, 2160p/4K)
- aspect_ratio — Video-Seitenverhältnis (Standard: auto, Optionen: auto, 16:9, 9:16)
- fps — Bilder pro Sekunde (Standard: 25, Optionen: 24, 25, 48, 50)
- generate_audio — KI-Audio passend zum Video generieren (Standard: true)
📁 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/img2vid.py --config config.json
4. Ergebnisse melden
Teilen Sie dem Benutzer mit:
- Ausgabedateipfade
- Videodauer und Auflösung
- Kostenschätzung (basierend auf Dauer und Auflösung)
- Direkte Download-URLs (Videos werden vorübergehend auf fal.media gehostet)
Konfigurationsreferenz
| Schlüssel | Werte | Standard | Beschreibung |
|---|---|---|---|
input_dir | Pfad | ./input | Ordner mit Quellbildern |
output_dir | Pfad | ./output | Zielordner |
prompt | Zeichenfolge | (erforderlich) | Bewegungsbeschreibung |
duration | Ganzzahl | 6 | Videodauer in Sekunden (6-20) |
resolution | Zeichenfolge | 1080p | Ausgabeauflösung: 1080p, 1440p, 2160p |
aspect_ratio | Zeichenfolge | auto | Seitenverhältnis: auto, 16:9, 9:16 |
fps | Ganzzahl | 25 | Bilder pro Sekunde: 24, 25, 48, 50 |
generate_audio | boolesch | true | KI-Audio für das Video generieren |
end_image_url | Zeichenfolge | null | Optionales Endbild für Übergangsvideos |
Häufige Befehle
# Mit einem Bewegungs-Prompt animieren (verwendet Standardwerte: 6s, 1080p, 25fps)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "langsamer filmischer Push-In, goldenes Stundenlicht"
# Ein längeres 10-Sekunden-Video generieren
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "sanfter Wind in den Bäumen" --duration 10
# Ein vertikales Video für soziale Medien erstellen
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "subtile Kamerabewegung" --aspect-ratio 9:16
# 4K-Qualität (höhere Kosten: $0,16/s)
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "filmischer Zoom-Out" --resolution 2160p --duration 8
# Höhere Bildrate für flüssigere Bewegungen
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "schnelle Actionszene" --fps 48
# Audiogenerierung deaktivieren
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "stille Meditationsszene" --no-audio
# Übergang zwischen zwei Bildern erstellen
cd "$SKILL_DIR" && uv run python scripts/img2vid.py \
--prompt "sanfter Morphing-Übergang" \
--end-image /pfad/zum/endbild.jpg
Ausgabe
Jedes Eingabebild erzeugt einen .mp4-Clip im output_dir, benannt als <bild_name>.mp4. Das Video wird außerdem vorübergehend auf das fal.media CDN hochgeladen, und eine Download-URL wird in der Konsolenausgabe bereitgestellt.
Videometadaten (Auflösung, fps, Dauer) werden nach der Generierung ausgegeben.
Fehlerbehandlung
- Fehlender FAL_API_KEY → klare Fehlermeldung mit Einrichtungsanweisungen
- Ungültiges Bildformat → Fehlermeldung mit unterstützten Formaten (PNG, JPEG, WebP, AVIF, HEIF)
- API-Fehler → fal.ai-Fehlermeldung wird weitergegeben
- Netzwerkprobleme → Wiederholungslogik mit klaren Fehlermeldungen
Preisreferenz
| Auflösung | Preis pro Sekunde |
|---|---|
| 1080p | $0,04 |
| 1440p | $0,08 |
| 2160p (4K) | $0,16 |
Beispiele:
- 6s Video bei 1080p = $0,24
- 10s Video bei 1080p = $0,40
- 10s Video bei 4K = $1,60