Video-Prompt-Builder
Generischer, anbieterunabhängiger Verteiler für Videogenerierungs-Prompts. Liest die Routing-Matrix in .specs/architecture/PROVIDERS.md, entscheidet, welcher Anbieter den Auftrag ausführen soll, und delegiert an den richtigen Spezialisten (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).
Wann aufrufen
- Jeder Videogenerierungsschritt in der Pipeline (
Brief -> Skript -> Creative, wenn der Creative-Typ Video ist). - Wenn ein Piece
type: videoin.specs/pieces/*.mddeklariert. - A/B-Tests von Video-Hooks über mehrere Anbieter hinweg und der Orchestrator benötigt einen einheitlichen Einstiegspunkt.
- Erneute Ausführung desselben Briefs auf einem anderen Anbieter, nachdem ein A/B-Gewinner ermittelt wurde.
- Wenn ein vorgeschalteter Agent einen Brief hat, aber nicht weiß, welchen Anbieter er wählen soll.
Eingaben
brief: Objekt. Visueller Brief mit mindestenssubject,motion,mood,aspect,duration_seconds.task_kind: Zeichenkette. Einer voncinematic_reel,motion_control,ugc_product_holder,product_demo,talking_head,batch_hook_test,motion_typography,data_viz_reel,programmatic_short.piece_path: Zeichenkette, optional. Pfad zur Piece-Datei. Kannprovider_override.videoenthalten.dry_run: Boolesch, optional. Wenn wahr, wird der aufgelöste Anbieter und die Parameter zurückgegeben, ohne das MCP aufzurufen.
Ablauf
.specs/architecture/PROVIDERS.mdlesen und die Video-Matrix in einetask_kind -> provider-Zuordnung parsen.- Wenn
piece_pathgesetzt ist undprovider_override.videoenthält, wird der Überschreibungswert verwendet. - Sonst
task_kindin der Matrix nachschlagen. Bei Unbekanntheit auf den Matrix-Standardwert fürcinematic_reelzurückfallen. - Überprüfen, ob die Umgebungsvariablen für den ausgewählten Anbieter gesetzt sind (
HIGGSFIELD_MCP_ACTIVE,TOPVIEW_API_KEY,WAVESPEED_API_KEY,HYPERFRAMES_ACTIVE). - Anbieter auf Spezialisten-Skill abbilden: Higgsfield ->
higgsfield-prompt-builder, Topview ->topview-prompt-builder, Wavespeed ->wavespeed-batch, Hyperframes ->hyperframes-prompt-builder. brief-Felder in die vom Spezialisten erwartete Eingabeform übersetzen.- Den Spezialisten aufrufen und dessen
paramsundmcp_tool-Ausgabe erfassen. - Wenn
dry_run, den aufgelösten Anbieter, die Parameter und das MCP-Tool zurückgeben. Andernfalls das MCP aufrufen und die Artefakt-Referenz zurückgeben. - Den Lauf mit Zeitstempel, Anbieter,
task_kindund Ergebnis indata/video-usage.jsonlprotokollieren.
Ausgaben
provider_used: Zeichenkette.params: Objekt. Endgültiges Parameterobjekt für den MCP-Aufruf.mcp_tool: Zeichenkette. Der Name des MCP-Tools.artifact_ref: Zeichenkette, wenn nicht imdry_run-Modus. Pfad oder URL zum generierten Video.cost_estimate_usd: Zahl.
Beispiele
Beispiel 1: Kinoreel an Higgsfield weitergeleitet
Eingabe: { brief: { subject: "Model im Leinenanzug", motion: "Tracking Shot", mood: „redaktionell“, aspect: “9:16”, duration_seconds: 6 }, task_kind: „cinematic_reel“ }
Ausgabe: { provider_used: “higgsfield“, mcp_tool: “higgsfield_seedance_generate“, params: {...} }
Beispiel 2: UGC-Anzeige an Topview weitergeleitet
Eingabe: { brief: { subject: “Hautpflegeflasche, gehalten von Avatar“, motion: “statisch”, mood: “freundlich”, aspect: “9:16”, duration_seconds: 15 }, task_kind: “ugc_product_holder” }
Ausgabe: { provider_used: “topview“, mcp_tool: “topview_avatar_generate“, params: {...} }
Beispiel 3: Wöchentlicher KPI-Reel an Hyperframes weitergeleitet
Eingabe: { brief: { headline: “Semana 21 em números”, aspect: “9:16”, duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: “programmatic_short” }
Ausgabe: { provider_used: “hyperframes”, mcp_tool: “hyperframes_render”, params: { composition_spec: {...}, render_args: {...} } } — lokales Rendering über die Skills hyperframes + hyperframes-cli.
Fehlermodi
task_kindnicht in der Matrix: Eine Warnung protokollieren und den Standardwertcinematic_reelverwenden.- Erforderliche Umgebungsvariable für den ausgewählten Anbieter fehlt: zum nächsten Anbieter in der Matrix wechseln und eine Warnung ausgeben.
- Spezialisten-Skill gibt einen Fehler zurück: Fehler weiterleiten und nicht automatisch auf einem anderen Anbieter wiederholen, es sei denn, der Aufrufer stimmt zu.
- Dauer überschreitet das Anbieter-Limit: auf das Maximum des Anbieters kürzen und einen Hinweis ausgeben.
Verwandte Skills
higgsfield-prompt-builder: Spezialist für Soul, DoP, Seedance.topview-prompt-builder: Spezialist für UGC- und Avatar-gesteuerte Anzeigen.wavespeed-batch: Spezialist für günstige Batch-Hook-Tests.hyperframes-prompt-builder: Spezialist für HTML-gerenderte Bewegungsgrafiken, Datenvisualisierungs-Reels und parametrisierte programmatische Kurzvideos.llm-router: Separater Verteiler für Textgenerierung; gleiches Muster, andere Domäne.qa-tech-specs: Validiert das endgültige Video gegen die Plattformspezifikation.