Conz-Wilts/ai-editor

Erzeugt neues Filmmaterial mit Higgsfield und fügt es in die Timeline des Schnitts ein. Berechnet vorab den Preis, fragt den Benutzer mit dem Dollarbetrag (und bei eigenem Filmmaterial, ob es an Higgsfield hochgeladen werden darf), sendet ab, wartet, lädt das Ergebnis in den generierten/ Ordner des Schnitts herunter und fügt es der Spur „Generiert“ hinzu. Deckt Motion Transfer auf einem Clip des Benutzervideos (seine Bewegungen auf eine Figur oder einen Stil übertragen), B-Roll aus einem Satz (Text-zu-Video), ein Standbild zum Leben erweckt (Bild-zu-Video) und Standbilder für Karten (Text-zu-Bild) ab. Verwenden, wenn der Benutzer „B-Roll generieren“, „einen Shot von“, „KI-B-Roll“, „einen Clip generieren“, „Higgsfield verwenden“, „Motion Transfer“, „meine Bewegungen auf“ oder „diesen Teil mit KI umgestalten“ sagt oder nach Filmmaterial fragt, das er nicht gedreht hat. Nicht für animierte Diagramme oder Motion Graphics (Bewegung), nicht für echte Screenshots und Logos (Overlays, Logo-Pack) und nicht für den Schnitt (Cut).

Was ist ai-editor?

Diese AI-Editor-Fähigkeit integriert die Higgsfield-KI-Plattform direkt in den Video-Editor, um in Sekundenschnelle neues Filmmaterial zu generieren – ohne dass der Editor verlassen werden muss. Sie unterstützt vier Erstellungsarten: Motion Transfer (eigene Bewegungen auf eine Figur übertragen), B-Roll aus Text (Text-zu-Video), Standbild-beleben (Bild-zu-Video) und Standbilder für Karten (Text-zu-Bild). Jede Generierung wird vor der Ausführung bepreist, und die Zustimmung des Benutzers muss vor dem Absenden erteilt werden; dabei wird auch die Genehmigung für das Hochladen von Benutzermaterial eingeholt. Das generierte Filmmaterial wird automatisch in den generierten/ Ordner heruntergeladen, auf der Spur „Generiert“ in der Timeline platziert und als Claude-Änderung markiert. Die Fähigkeit respektiert Budgetobergrenzen (monatlich über ein Budget-Feld konfigurierbar), lehnt fehlgeschlagene oder NSFW-Ergebnisse kostenlos ab und bietet dem Benutzer an, Aufforderungen zu ändern. Kommuniziert über die Frage-Box mit dem Benutzer, zeigt Preise, Optionen und den Fortschritt der Hintergrundjobs an. Entwickelt für Claude Code, Cursor und andere agentenbasierte Entwicklerumgebungen, die SKILL.md unterstützen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Conz-Wilts/ai-editor/tree/HEAD/.claude/skills/generate

Dokumentation

Generieren

Pfade: ${CLAUDE_SKILL_DIR} bezeichnet den Ordner, der diese SKILL.md enthält, und ${CLAUDE_SKILL_DIR}/../.. den Editor-Ordner (das .claude/ dieses Repos) zwei Ebenen darüber.

Jede Frage an den Benutzer erfolgt im Fragefeld: Verwenden Sie das Tool AskUserQuestion (2-4 Optionen, die empfohlene zuerst). Nur in einem Agenten ohne dieses Tool fragen Sie nummeriert im Text.

G="${CLAUDE_SKILL_DIR}/../../lib/ai_editor/gen/gen.py". Führen Sie es mit python3 (unter Windows py) aus. Jedes Modell, seine Eingaben und Grenzen stehen in gen.py models (aus lib/ai_editor/gen/models.json); raten Sie niemals eine Modell-ID oder einen Parameter. API-Fakten und was unbestätigt ist: references/higgsfield-api.md.

Regeln

Geld wird nur nach einer Zustimmung zu diesem Preis ausgegeben. Immer zuerst estimate ausführen, mit dem gedruckten Dollarbetrag (seiner ASK:-Zeile) fragen und submit --confirm <estimate id> erst ausführen, nachdem der Benutzer mit Ja geantwortet hat. Ein neuer Preis (der Kostenvoranschlag ist älter als 30 Minuten oder submit meldet eine Preisänderung) ist eine neue Frage.
Das Filmmaterial des Benutzers verlässt seinen Computer nur mit Zustimmung. Ein Clip oder ein Bild seines Videos wird bei submit an Higgsfield hochgeladen. Dies in derselben Frage wie den Preis erwähnen.
Niemals nach dem Schlüssel im Chat fragen. Kein Schlüssel: Anweisen, python3 "$G" setkey im eigenen Terminal auszuführen (es fragt nach Schlüssel-ID und Geheimnis von console.higgsfield.ai, verbunden als id:secret, und versteckt die Eingabe).
profile.json gen_budget_usd begrenzt die monatlichen Ausgaben; submit lehnt darüber hinaus ab. Angeben, was übrig ist, und anhalten.
Fehlgeschlagene und nsfw-Ergebnisse werden nicht berechnet. Dies erwähnen, wenn eines fehlschlägt, und anbieten, die Aufforderung zu ändern.

Schritte

Was und wo. Aus den Worten des Benutzers und dem Schnitt (edits/<name>/): die Art (Motion Transfer, B-Roll aus Text, Standbild-beleben, Standbild für Karte), den Zeitpunkt, den es abdeckt (Sekunden auf der Timeline, aus dem Transkript in words.json), und bei Motion Transfer den Abschnitt ihres Videos (4 s oder mehr; das Modell behält maximal 30 s). Das Modell mit python3 "$G" models --kind <kind> auswählen.
Die Aufforderung. Selbst aus der gesprochenen Zeile schreiben: das Subjekt, die Umgebung, die Kamera, das Licht, in unter 40 Wörtern. B-Roll passt sich dem Videoformat an (ein vertikaler Schnitt erhält einen vertikal wirkenden Shot). Motion Transfer benötigt 1-8 Referenzbilder (--image, Dateien oder URLs): den Look, auf den die Bewegungen übertragen werden.
Preis berechnen.
```
python3 "$G" estimate edits/<name> --model <id> --prompt "<aufforderung>" [--video raw.mp4 --from 12.0 --to 18.0] \
  [--image ref.png] [--param duration=5] --at <timeline sekunden>
```
Es schneidet den Clip (stumm, H.264) in generated/inputs/, berechnet den Preis, ohne etwas hochzuladen, und gibt die Kostenvoranschlags-ID, usd, credits, over_budget und eine ASK:-Zeile aus.
Fragen. Ein Fragefeld: die ASK:-Zeile als Frage (Preis, Modell und was hochgeladen wird), Optionen „Ja, generieren (Empfohlen)“ / „Aufforderung ändern“ / „Nein“. Bei Budgetüberschreitung stattdessen mitteilen und anhalten.
Absenden nur bei Ja: python3 "$G" submit edits/<name> --confirm <estimate id>. Es lädt die Eingaben hoch, berechnet den Preis neu, sendet ab und gibt die Job-ID aus.
Warten im Hintergrund (Generationen dauern Minuten): python3 "$G" wait edits/<name> <job>. Es fragt mit Backoff ab, lädt das Ergebnis in edits/<name>/generated/ herunter, untersucht es und fügt es der Spur „Generiert“ der Timeline an der Stelle --at als Claude-Änderung hinzu (über project.py apply; ohne das Projektdokument schreibt es generated/<job>.ops.json und gibt es aus). status / list zeigen den Fortschritt; cancel funktioniert nur, während es noch in der Warteschlange ist.
Übergeben. Sagen, was hinzugefügt wurde, wo und was es gekostet hat. Der Benutzer verschiebt, trimmt oder löscht es auf der Timeline wie jeden anderen Clip. Eine Korrektur, wie Generationen aussehen sollen, geht in taste.

Wenn ein Befehl stoppt

Meldung	Handlung
`No Higgsfield key`	Benutzer bitten, `python3 "$G" setkey` in seinem eigenen Terminal auszuführen, dann fortfahren
`needs at least 4 s`	`--from`/`--to` erweitern oder ein Text- oder Bildmodell wählen
`over this month's generation budget`	mitteilen, was übrig ist; Benutzer kann `gen_budget_usd` erhöhen
`the price is $X, not $Y`	erneut mit dem neuen Preis fragen, dann `submit --confirm` mit der neuen gedruckten ID ausführen
`Maximum number of concurrent requests`	der Client hat bereits wiederholt; auf einen laufenden Job warten, dann absenden
`ended failed` / `ended nsfw`	nicht berechnet; geänderte Aufforderung anbieten (neuer Kostenvoranschlag und Frage)

Dateien

lib/ai_editor/gen/gen.py: die obigen Befehle, demo Selbsttest (ein Fake-Higgsfield, kein Netzwerk).
lib/ai_editor/gen/higgsfield.py: der API-Client. base.py: das Anbieter-Interface und der Katalog.
lib/ai_editor/gen/jobs.py: edits/<name>/generated/jobs.json und die monatlichen Ausgaben.
references/higgsfield-api.md: die API wie dokumentiert, mit Quellen.