Video-Generator — Multi-Modell-Cloud-Video (Higgsfield)
Generiert Videoclips über Higgsfield – eine Plattform, die 6+ führende Modelle unter einer API und einem Abrechnungskonto vereint. Wählen Sie das passende Modell nach Kosten- vs. Qualitätsabwägung; der Rest der Oberfläche ist identisch.
Das Skill-Verzeichnis (in dem diese SKILL.md liegt) wird nachfolgend als $SKILL_DIR bezeichnet.
Cloud-basiert. Keine lokale GPU erforderlich. Erfordert ein Higgsfield-Konto und einen API- Schlüssel von cloud.higgsfield.ai.
Modi
| Modus | Auslöser | Was passiert |
|---|---|---|
text-to-video | Keine Bilder in input/ | Erzeugt ein Video allein aus dem Prompt |
image-to-video | Bilder in input/ vorhanden | Animiert jedes Bild in einen Clip |
auto (Standard) | — | Wählt automatisch den obigen Modus |
Presets
Das Skill verwendet Presets als dünne Überlagerungen auf derselben Video-Engine. Ein Preset kann das Standard-Modell, das Seitenverhältnis, die Dauer und ein Prompt-Präfix setzen. Explizite Konfigurationswerte haben weiterhin Vorrang.
| Preset | Am besten geeignet für | Standard-Modell | Standard-Seitenverhältnis |
|---|---|---|---|
cinematic (Standard) | Allgemeine filmische Videos | kling | 16:9 |
social-hook | Kurzformat-Videos zum Anhalten des Scrollens | seedance | 9:16 |
motion-design-ad | SaaS/Produkt-Bewegungsanzeigen | kling | 16:9 |
ecommerce-ad | Produkt-Werbeclips | kling | 9:16 |
brand-story | Gründer-/Marken-Erzählung | kling | 16:9 |
product-360 | Isolierte Produktpräsentation | kling | 1:1 |
Workflow-Regeln:
- Wählen Sie ein Preset aus, bevor Sie
config.jsonbearbeiten - Überprüfen Sie, ob das Preset zum gewünschten Ausgabestil passt
- Falls der Benutzer keins wählt, behalten Sie das Standard-Preset bei und notieren Sie es in der Konfiguration
- Verwenden Sie denselben Stil nicht doppelt; wenn der Prompt bereits zum Preset passt, lassen Sie den Prompt unverändert
Modelle
| Schlüssel | Vollständige Modell-ID | Am besten geeignet für |
|---|---|---|
kling (Standard) | kling-video/v2.1/pro/image-to-video | Realistische Bewegung, kosteneffizient |
seedance | bytedance/seedance/v1/pro/image-to-video | Native Audio-Synchronisation |
dop | higgsfield-ai/dop/standard | Cinema Studio optische Physik |
dop-preview | higgsfield-ai/dop/preview | Cinema Studio (Vorschaustufe) |
Dies sind die in der offiziellen Dokumentation bestätigten Modell-IDs. Weitere Modelle (Sora, Veo, Wan, usw.) finden Sie unter cloud.higgsfield.ai/explore. Um eines hinzuzufügen, fügen Sie es in
MODEL_IDSingenerate.pyein und fügen Sie einen--model-Alias hinzu.Guthaben wird nur für erfolgreiche Generierungen abgerechnet; fehlgeschlagene und NSFW-Anfragen werden erstattet.
Einrichtung (nur beim ersten Mal)
cd "$SKILL_DIR" && uv sync
Holen Sie sich Anmeldedaten von cloud.higgsfield.ai (API-Key + API-Secret), und exportieren Sie sie mit einer dieser Formen:
# Option A – kombiniert (empfohlen)
export HF_KEY="your-api-key:your-api-secret"
# Option B – getrennte Variablen
export HF_API_KEY="your-api-key"
export HF_API_SECRET="your-api-secret"
Agenten-Workflow
1. Fragen Sie den Benutzer
Bevor ich das Video erstelle, muss ich Folgendes wissen:
🎬 Modus
- Text-zu-Video (nur Prompt) oder Bild-zu-Video (Bilder in input/ ablegen)
- Standard: automatische Erkennung
🎛️ Preset (Standard: cinematic)
- cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360
- Überprüfen Sie die Wahl, bevor Sie config.json schreiben
- Falls nicht angegeben, Standard-Preset behalten und diese Wahl notieren
🤖 Modell (Standard: kling)
kling · seedance · dop · dop-preview
Empfehlung: kling für Geschwindigkeit/Kosten, seedance für Qualität
💬 Prompt (erforderlich)
Beschreiben Sie die Bewegung oder Szene, z.B.:
"langsamer filmischer Push-In, warmes goldenes Stundenlicht, subtile Kameradrift"
⚙️ Einstellungen
- duration — Videolänge in Sekunden (Standard: 6, Bereich: 3–16)
- aspect_ratio — 16:9 · 9:16 · 1:1 (Standard: 16:9)
- resolution — 720p · 1080p (Standard: 1080p)
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 Entscheidungen des Benutzers.
Setzen Sie preset explizit, auch wenn der Standardwert verwendet wird.
3. (Nur Bild-zu-Video) Bilder ablegen
Kopieren Sie Quellbilder nach $SKILL_DIR/input/. Unterstützt: .jpg .jpeg .png .webp
4. Ausführen
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. Ergebnisse melden
Teilen Sie dem Benutzer mit:
- Ausgabedateipfad(e) in
output/ - Verwendetes Modell und ungefähre Guthabenkosten
- Videodauer und Auflösung
Konfigurationsreferenz
| Schlüssel | Werte | Standard | Beschreibung |
|---|---|---|---|
input_dir | Pfad | ./input | Quellbilder (nur Bild-zu-Video) |
output_dir | Pfad | ./output | Wo MP4s geschrieben werden |
mode | auto · text-to-video · image-to-video | auto | Generierungsmodus |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | Kreative Preset-Überlagerung |
model | kling · seedance · dop · dop-preview | kling | Welches Modell verwendet werden soll |
prompt | Zeichenkette | (erforderlich) | Bewegungs- oder Szenenbeschreibung |
duration | Ganzzahl 3–16 | 5 | Videolänge in Sekunden |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | Ausgabe-Seitenverhältnis |
extra_params | Objekt | {} | Durchreich-Parameter an die Modell-API |
Häufige Aufrufe
# Text-zu-Video mit Standard-Modell (kling)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "Drohnenaufnahme über nebligen Bergen bei Sonnenaufgang" --duration 8
# Bild-zu-Video mit Kling (Bilder vorher in input/ ablegen)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "langsamer filmischer Push-In, goldenes Stundenlicht" --model kling
# Höhere Qualität: Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "Luftaufnahme-Rückzug über eine neblige Stadt im Morgengrauen" --model seedance
# Vertikales Video für Reels/TikTok
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "sprechender Kopf, natürlicher Bokeh-Hintergrund" \
--aspect-ratio 9:16 --model kling
# Schneller Entwurf: niedrigere Auflösung, kürzerer Clip
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "Produkt-Enthüllung auf dunklem Hintergrund" \
--resolution 720p --duration 4 --model dop-preview
Ausgabe
Jeder Job schreibt eine .mp4 in output_dir:
- Text-zu-Video:
output.mp4 - Bild-zu-Video:
<bildname>.mp4pro Eingabebild
vs. animate-image
animate-image | video-generator | |
|---|---|---|
| Anbieter | fal.ai | Higgsfield |
| Modus | nur Bild→Video | Text→Video + Bild→Video |
| Modell | LTX-2.3 Fast (fest) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| Geschwindigkeit | Sehr schnell | Modellabhängig |
| Maximale Auflösung | 4K | 1080p |
| Filmische Steuerung | Nein | Über extra_params |
Verwenden Sie animate-image für schnelle, günstige, hochauflösende Clips aus Bildern.
Verwenden Sie video-generator, wenn Sie Text-zu-Video, Modellauswahl oder die filmischen
Physiksteuerungen von Higgfields Cinema Studio benötigen.
API-Hinweise
Das Skill kommuniziert direkt mit der Higgsfield REST API (cloud.higgsfield.ai).
Modell-Endpunkt-Pfade sind in MODEL_ENDPOINTS am Anfang von generate.py definiert.
Wenn Higgsfield eine Route aktualisiert, überschreiben Sie sie über die Konfiguration "extra_params" oder
aktualisieren Sie die Konstante – keine weiteren Änderungen erforderlich.