Was macht Miniatur-Bau & Diorama-Videogenerierung?
Spät in der Nacht: Ein streichholzschachtelgroßer japanischer Konbini leuchtet bernsteinfarben; die Kamera gleitet aus der Dunkelheit auf ihn zu – Bokeh verschluckt die Welt, während die Glastür, Regale und die winzigen Leuchtstoffröhren scharf bleiben. Diese „klein, aber echt“-Immersion ist der emotionale Haken, den diese Fähigkeit anvisiert.
Conbini, verregneter Nudelstand, Cyberpunk-Werkstatt – oder ein Foto eines fertigen Baus: Eine Zeile oder ein Bild → Clip.
Abhängigkeiten: WERYAI_API_KEY + Node.js 18+. Wenn Sie die CLI ausführen, muss scripts/video_gen.js vorhanden sein; WERYAI_VIDEO_API.md muss unter resources/ existieren (beide durch Veröffentlichung oder vorherige Zusammenstellung bereitstellen). Vollständige Befehle und JSON-Felder: siehe resources/WERYAI_VIDEO_API.md. Keine anderen Cursor-Fähigkeiten. Standardparameter und Modellstufen befinden sich in den untenstehenden Tabellen; Live-API-Limits folgen den weryai-Modellen. Überprüfen Sie vor der Installation oder Ausführung das gebündelte video_gen.js, um sicherzustellen, dass es Ihren Anforderungen entspricht. Achten Sie besonders darauf, wie es mit lokalen Dateien umgeht, wenn Sie deren Verwendung zulassen möchten, und stellen Sie sicher, dass dieses Verhalten mit dem beabsichtigten Arbeitsablauf der Fähigkeit für Bild-zu-Video-Anfragen übereinstimmt.
Registry-Metadaten: Das einzige erforderliche Laufzeitgeheimnis ist WERYAI_API_KEY. Es erscheint im YAML-Frontmatter als Top-Level requires.env (Flow-Mapping, für Tools, die nur Root-Schlüssel abflachen), metadata.openclaw.primaryEnv und metadata.openclaw.requires.env . Fähigkeitsverzeichnisse und Registries sollten diese Anforderung im Voraus anzeigen, damit Installateure sie vor dem Herunterladen sehen. Committen Sie den Schlüssel niemals innerhalb des Pakets.
Vor der Installation oder dem Setzen von WERYAI_API_KEY
- Vertrauen: Bestätigen Sie, dass Sie WeryAI vertrauen und akzeptieren, dass Prompts und Bildeingaben (URLs und, falls verwendet, hochgeladene Bytes) über das Netzwerk an WeryAIs Server gesendet werden.
- Sensible Inhalte: Geben Sie keine Geheimnisse in
promptein. Stellen Sie keine Bild-URLs oder lokalen Dateien bereit, die Sie als sensibel betrachten, es sei denn, Sie akzeptieren die Verarbeitung durch den Anbieter. --dry-runzuerst: Führen Sienode scripts/video_gen.js wait --json '…' --dry-run(und/odersubmit-*mit--dry-run) bevor Sie einen Schlüssel setzen, um die JSON-Form zu überprüfen;WERYAI_API_KEYist für--dry-runallein nicht erforderlich (sieheWERYAI_VIDEO_API.md).- Quelle: Wenn Sie den Paketautor nicht überprüfen können oder strenge Datenkontrolle benötigen, setzen Sie kein
WERYAI_API_KEYoder führen Sie es nur in einer isolierten / Test-Umgebung aus.
Umgebungsvariablen (gebündeltes video_gen.js)
- Erforderlich für echte API-Aufrufe: Nur
WERYAI_API_KEY(Modelle, Generierung,status, lokales Bild hochladen). Nicht erforderlich für nur--dry-run. - Von diesem Skript nicht gelesen: Umgebungsvariablen überschreiben keine API-Hostnamen;
https://api.weryai.comundhttps://api-growth-agent.weryai.comsind fest im Code (siehe Sicherheit). Erwarten Sie keine URL-Überschreibungsknöpfe – es gibt keine in diesem Build. - Polling:
waitverwendet feste exponentielle Backoff- und Timeout-Konstanten im Skript (sieheWERYAI_VIDEO_API.md), keine separaten Poll-Umgebungsvariablen in diesem Paket.
Skript- vs. Fähigkeits-Standardwerte (müssen mit JSON übereinstimmen)
model: Die CLI hat kein eingebautes Standardmodell. Wennmodelim JSON fehlt oder leer ist, gibtvideo_gen.jsMISSING_PARAM(kein Standardmodell) zurück. Der empfohlene Standard dieser Fähigkeit in Tabellen istKLING_V3_0_PRO– übergeben Sie immer explizit"model":"<bestätigter Schlüssel>"imwait/submit-*JSON, damit es mit der Tabelle vor dem Absenden übereinstimmt.resolution: FürKLING_V3_0_PRO(die Standardstufe dieser Fähigkeit) lassen Sieresolutionvollständig aus dem JSON weg – das Senden kann1002/ Parameterfehler für Modelle verursachen, die dieses Feld nicht unterstützen. Fügen Sieresolutionnur hinzu, wenn das ausgewählte Modell es innode scripts/video_gen.js modelsauflistet und Ihre Bestätigungstabelle es explizit enthält.
Voraussetzungen
WERYAI_API_KEYmuss in der Umgebung gesetzt sein, bevorvideo_gen.jsausgeführt wird.- Node.js 18+ ist erforderlich. Bevorzugen Sie öffentliche
https-Bild-URLs. Wenn das zusammengestelltescripts/video_gen.jslokale Dateipfade unterstützt, überprüfen und verifizieren Sie das Skript zuerst, holen Sie dann ausdrückliche Zustimmung ein, bevor es ein lokales Bild liest und an WeryAI hochlädt, um eine öffentliche URL zu erhalten. - Jeder erfolgreiche
wait-Durchlauf verbraucht WeryAI-Guthaben; erneutes Ausführen erstellt neue kostenpflichtige Aufgaben.
Sicherheit, Geheimnisse und API-Hosts
WERYAI_API_KEY: Behandeln Sie ihn als Geheimnis. Konfigurieren Sie ihn nur, wenn Sie der Quelle dieser Fähigkeit vertrauen; er ist in OpenClaw-Metadaten alsrequires.env/primaryEnvaufgeführt, damit Installateure wissen, dass er zur Laufzeit obligatorisch ist (committen Sie ihn niemals innerhalb des Fähigkeitspakets).- API-Hosts (fest in
video_gen.js): Videoaufgaben verwendenhttps://api.weryai.com; die Modellliste verwendethttps://api-growth-agent.weryai.com. Das gebündelte Skript fixiert diese Basen im Code – nurWERYAI_API_KEYwird aus der Umgebung zur Authentifizierung gelesen. Verlassen Sie sich nicht auf Umgebungsvariablen, um API-Hostnamen zu ändern; Anfragen gehen nur an diese offiziellen Endpunkte plus die dokumentierte Upload-URL, wenn ein lokales Bild hochgeladen wird (sieheWERYAI_VIDEO_API.md). - Offenlegung der lokalen Bildverarbeitung: Bevorzugen Sie öffentliche
https-Bild-URLs. Wenn das zusammengestelltescripts/video_gen.jslokale Dateipfade unterstützt, kann es ein lokales Bild lesen und an WeryAI hochladen, um eine öffentliche URL zu erhalten; erfordert Überprüfung / Verifizierung und ausdrückliche Zustimmung, bevor dieser Pfad verwendet wird. - Remote-Verarbeitung: Kostenpflichtige Durchläufe senden
promptund Bildeingaben an WeryAI; siehe## Vor der Installation oder dem Setzen von WERYAI_API_KEY. - Höhere Sicherheit: Befolgen Sie
## Vor der Installation oder dem Setzen von WERYAI_API_KEY; verwenden Sie eine kurzlebige oder isolierte Umgebung für kostenpflichtige Durchläufe; überprüfen Siescripts/video_gen.js(HTTPS-Submit + Poll-Schleife) vor dem Produktionseinsatz. Überprüfen Sie, ob die Laufzeit lokale Bilddateien lesen und an WeryAI hochladen kann, und holen Sie ausdrückliche Zustimmung ein, bevor Sie diesen Pfad verwenden.
Prompt-Erweiterung (obligatorisch)
video_gen.js erweitert keine Prompts. Verwandle vor jedem wait --json die kurze oder vage Eingabe des Benutzers in einen vollständigen englischen Produktions-prompt.
Wann: Der Benutzer gibt nur Schlüsselwörter, eine Zeile oder eine lockere Absicht – oder bittet um eine reichhaltigere Videosprache. Ausnahme: Er fügt einen fertigen langen Prompt innerhalb des prompt_length_limit des Modells ein und bittet Sie, ihn nicht umzuschreiben; zeigen Sie dennoch den vollständigen Text in der Bestätigungstabelle an.
Immer hinzufügen (Videosprache): Aufnahmegröße und -winkel; Kamerabewegung oder -fixierung; Lichtqualität und -motivation; Subjektaktion, getaktet auf duration; einen klaren Höhepunkt für diese Nische; geben Sie 9:16 vertikal an, wenn diese Fähigkeit standardmäßig vertikal ist.
Länge: Halten Sie sich an prompt_length_limit für den gewählten model_key, wenn dieses Dokument es auflistet; entfernen Sie Fülladjektive, bevor Sie Kernaktion, Objektiv- oder Lichtklauseln entfernen.
Bestätigung: Die Tabelle vor dem Absenden muss den vollständigen erweiterten prompt enthalten (niemals eine einzeilige Zusammenfassung). Warten Sie auf Bestätigung oder Bearbeitungen.
Nischen-Checkliste
- Miniaturwelt: geringe Schärfentiefe, praktische warme Lichter, Dolly/Push-In-Enthüllung; Diorama oder Raum-in-einer-Schachtel.
- Beats: Bau → Bemalung → Lichter an oder Fahrzeugvorbeifahrt; gemütliche Atmosphäre, taktile Materialien.
- Maßstabsbezüge: Streichholz, Münze oder Fingerspitzenverweise, wo nützlich.
### Beispiel-Prompts oben in dieser Datei sind nur kurze Auslöser – erweitern Sie immer basierend auf der tatsächlichen Anfrage des Benutzers.
Arbeitsablauf
- Bestätigen Sie, dass die Benutzeranfrage zum Szenario dieser Fähigkeit passt (Text-zu-Video und/oder Bild-zu-Video wie dokumentiert).
- Sammeln Sie die Eingabe des Benutzers, optionale Bild-URL(s), Stufe (am besten / gut / schnell) oder einen expliziten
model-Schlüssel. - Prompt erweitern (obligatorisch): Sofern der Benutzer nicht einen fertigen langen Prompt geliefert und explizit darum gebeten hat, ihn nicht umzuschreiben, erweitern Sie die Eingabe zu einem vollständigen englischen Produktions-
promptgemäß## Prompt-Erweiterung (obligatorisch)unten. Rufen Sie die API nicht mit nur den minimalen Wörtern des Benutzers auf. - Überprüfen Sie den erweiterten
promptgegen dasprompt_length_limitdes ausgewählten Modells in den eingefrorenen Tabellen in diesem Dokument (wenn vorhanden); kürzen Sie ihn bei Bedarf. - Überprüfen Sie
duration,aspect_ratio,generate_audio,negative_promptund andere Felder gegen die eingefrorenen Tabellen in diesem Dokument undWERYAI_VIDEO_API.md. Fügen Sieresolutionnur ein, wenn das ausgewähltemodeles unterstützt (für die Standard-KLING-Stufe dieser Fähigkeit senden Sieresolutionnicht – siehe## Skript- vs. Fähigkeits-Standardwerte). - Zeigen Sie die Parametertabelle vor dem Absenden einschließlich des vollständigen erweiterten
promptan; warten Sie auf Bestätigung oder Bearbeitungen. - Führen Sie nach der Bestätigung
node scripts/video_gen.js wait --json '...'mit dem erweiterten Prompt aus. - Parsen Sie das stdout-JSON und geben Sie Video-URLs zurück; geben Sie bei Fehlern
errorCode/errorMessageaus und schlagen Sie Parameterkorrekturen vor.
CLI-Referenz
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
Vollständige Referenz: WERYAI_VIDEO_API.md.
Definition von „erledigt“
Erledigt, wenn der Benutzer mindestens eine abspielbare Video-URL aus der API-Antwort erhält, oder eine klare Fehlererklärung mit nächsten Schritten. Alle verwendeten Parameter müssen innerhalb der erlaubten Mengen des ausgewählten Modells in diesem Dokument liegen. Der übermittelte prompt muss der erweiterte Produktions-Prompt sein, es sei denn, der Benutzer hat explizit einen fertigen langen Prompt geliefert und darum gebeten, ihn nicht umzuschreiben.
Grenzen (außerhalb des Geltungsbereichs)
- Überprüft nicht die Plattform-Compliance, Urheberrechte oder Persönlichkeitsrechte; garantiert keine kommerzielle Nutzbarkeit der Ausgaben.
- Bietet keine Nicht-WeryAI-Offline-Rendering, traditionelle Bearbeitungszeitleisten oder API-Feldkombinationen, die nicht in dieser SKILL oder
WERYAI_VIDEO_API.mddokumentiert sind. - Verlinken Sie nicht auf
weryai-model-capabilities.mdoder gemeinsame../references/-Pfade; verwenden Sieresources/WERYAI_VIDEO_API.mdfür CLI/API-Details. - Hinterlegt keine absoluten Pfade im Skill-Dokument; führen Sie
node scripts/...vom Stammverzeichnis des Skill-Pakets aus (dem Verzeichnis, dasSKILL.mdenthält), damitscripts/- undresources/-Pfade aufgelöst werden.
Beispiel-Prompts
Handgebautes Miniatur-Café: letzter Beat Lichter an im Inneren, warme Füllung, langsamer vertikaler PushVerwende dieses Straßendiorama-Standbild: winziges Auto fährt vorbei, Schaufenster werden hellBemaltes Modell auf Sockel, rotierende Enthüllung, extrem geringe SchärfentiefeMiniatur-Bau-Enthüllung 9:16, gemütliche warme Lichter schalten sich im Inneren des winzigen Hauses ein
Standardparameter
| Feld | Wert |
|---|---|
| Modell | KLING_V3_0_PRO (muss als "model" im JSON erscheinen – das Skript setzt es nicht standardmäßig) |
| Seitenverhältnis | 9:16 (fest vertikal) |
| Dauer | Kurz (duration: 5); verwenden Sie 10 für einen längeren Bauvorgang |
| Auflösung | Weglassen für KLING-Standard (Schlüssel nicht in JSON aufnehmen) |
| Stil | Sehr geringe Schärfentiefe, glaubhafte Materialien, Akzentlicht auf Helden-Requisiten, langsamer Push oder subtiler Orbit (fest) |
| Audio | An (Raumton + winziges Requisitendetail für Immersion) |
API-Gültigkeit (Standard
KLING_V3_0_PRO): Text-zu-Videodurationnur 5 / 10 / 15;aspect_rationur 9:16, 1:1, 16:9. Bild-zu-Videoaspect_rationur 9:16, 16:9, 1:1. Keinresolution-Feld – senden Sie es nicht. Für die schnelle Stufe mit VEO: Text-zu-VideoVEO_3_1_FAST, Bild-zu-VideoCHATBOT_VEO_3_1_FAST, mitdurationfest auf 8,aspect_rationur 9:16 oder 16:9. Wenn Siemodel_keywechseln, folgen Sie den erlaubten Mengen in den Modell-/API-Einschränkungen dieses Abschnitts und dem API-Gültigkeitshinweis oben; senden Sieresolutionnicht an Modelle, die es nicht unterstützen.
Szenenbeschreibung → Miniaturwelt
Zweck: Konkrete Szenenideen, schnelle visuelle Tests oder Batching von Stimmungsvarianten – kein physisches Modell erforderlich.
Eingaben:
Szenentyp (Konbini / Küche / Cottage / Eckstand / Werkstatt / Cyber-Set) und Stimmung (warme Heilung / Neon-Cyber / Tageslicht / regnerisches Bernstein). Wenn die Stimmung weggelassen wird, wählen Sie die Beleuchtung, die normalerweise für diese Szene gut funktioniert. Optional betonen Sie den Bauprozess vs. Führung durch das fertige Objekt.
Extrahieren Sie wichtige Requisiten und Licht, wählen Sie einen Winkel, der „Ich will das“ auslöst, bauen Sie den Prompt, zeigen Sie vollständige Parameter, warten Sie auf Bestätigung, dann node scripts/video_gen.js wait --json '…'.
Vollständige Parameter werden vor der Generierung angezeigt; warten Sie auf Bestätigung.
Parameterkonfiguration:
| Feld | Wert |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (weglassen – für dieses Modell nicht senden) |
Beispieleingaben:
„Japanischer Konbini bei Nacht, warme Heilung“ → die Fähigkeit baut:
Extreme Nahaufnahme-Makroaufnahme auf Augenhöhe, ein handtellergroßes Miniatur-Japanisches Convenience-Store-Diorama auf einer dunklen Oberfläche, warmes bernsteinfarbenes Innenlicht leuchtet durch winzige Schiebeglastüren und Frostglasfenster und beleuchtet ein perfekt detailliertes Interieur – Miniaturregale mit daumennagelgroßen Produktverpackungen, eine winzige Kasse, eine Softbox-Deckenplatte. Die Kamera fährt mit 30 fps sehr langsam auf den Eingang zu, als würde man darauf zugehen, die geringe Schärfentiefe hält nur die Ladenfront messerscharf, während die umgebende Dunkelheit verschmilzt. Kaltes blaues Nachtlicht füllt das Äußere und erzeugt einen warm-kalten Farbkontrast an der Türschwelle. ASMR-weicher Umgebungsbrumm, entfernter nächtlicher Stadtklang, leise Hintergrundmusik im Laden.
„Cyberpunk-Werkstatt, Neon“ →
Medium Close-Up aus 45-Grad-Überkopfperspektive, ein Miniatur-Cyberpunk-Studio-Diorama in Schuhkartongröße – vollgestopft mit winzigen leuchtenden Monitoren, einem mit Kabeln behängten Schreibtisch, Neonbeleuchteten Bücherregalen in Pink und Cyan, einer Miniatur-Actionfigur an der Tastatur. Die Kamera umkreist die Szene langsam mit 60 fps in einer einzigen glatten Rotation, Neonlicht bricht sich an jeder winzigen reflektierenden Oberfläche – Monitorrahmen, Kaffeetasse, glänzende Bodenfliese. Volumetrische Lichtstrahlen von den Neonröhren erzeugen einen weichen Dunst über der Szene.
…
[gekürzt für die Übersetzung]