HiAPI Seedance 2.0 UGC-Anzeigenvideo

Was macht HiAPI Seedance 2.0 UGC-Anzeigenvideo?

Erstellen Sie vertikale Produktanzeigen, die sich anfühlen, als würde ein Creator ein Produkt authentisch präsentieren, während jede Produktbehauptung, jedes Abbild und jedes ausgegebene Artefakt überprüfbar bleibt.

Verwenden Sie die installierte hiapi-seedance-2-0-video-Implementierung für Payload-Validierung, Task-Übermittlung, Abfrage und Download. Überschreiben Sie nicht den HiAPI-Transport. Dieses Skill fügt die Schichten für UGC-Recherche, Drehbuch, Referenz-Assets, Kampagnenvarianten und Qualitätskontrolle hinzu.

Harte Regeln

• Verwenden Sie das Bild einer echten Person nur, wenn der Benutzer es bereitgestellt oder ein genehmigtes Asset identifiziert hat und die Erlaubnis zur Nutzung dieses Abbildes bestätigt wurde. Imitieren Sie keine Werbung durch Prominente, öffentliche Personen, Kunden oder Creator.
• Kennzeichnen Sie einen generierten Darsteller im Brief als synthetisch. Präsentieren Sie eine synthetische Darbietung nicht als ungeschriebenes Kundenreferenz.
• Stützen Sie Vorteile, Spezifikationen, Preise, Rabatte, Vergleiche und Ergebnisse auf die Materialien des Benutzers oder aktuelle Primärquellen. Erfinden Sie keine Bewertungen, Nutzungsgeschichte, Vorher/Nachher-Ergebnisse, Knappheit oder persönliche Erfahrung.
• Behandeln Sie Gesundheits-, Medizin-, Nahrungsergänzungs-, Gewichtsverlust-, Finanz-, Alkohol-, Glücksspiel- und andere regulierte Kategorien als genehmigungspflichtig. Überprüfen Sie vor der Erstellung des endgültigen Anzeigentextes die aktuellen offiziellen Plattform- und Rechtsvorschriften.
• Platzieren Sie keine ungeprüften Texte, Etiketten, Preise oder Abzeichen innerhalb des generierten Videos. Fügen Sie Untertitel und Angebotstexte erst in der Nachbearbeitung hinzu, nachdem Sie das gesprochene Audio überprüft haben.
• Veröffentlichen, planen oder laden Sie nichts öffentlich hoch, es sei denn, der Benutzer fordert diese separate Aktion ausdrücklich an.
• Generieren Sie nicht in 4k und verwenden Sie keine kostenpflichtigen persistenten Speicher ohne explizite Kostenbestätigung.

Standardeinstellungen

Verwenden Sie diese, wenn die Anfrage sie nicht angibt:

• Plattformen: TikTok und Instagram Reels
• Seitenverhältnis: 9:16
• Dauer: 10 Sekunden
• Auflösung: 720p für einen Entwurf; verwenden Sie 1080p, wenn der Benutzer Auslieferungsqualität anfordert
• Audio: Seedance-nativer Dialog aktiviert
• Struktur: eine durchgehende Handkameraaufnahme mit vier Mikro-Beats
• Sprache: entsprechen der des Benutzers oder des von ihm genannten Zielmarktes
• Speicher: temporäre Ausgabe, lokal heruntergeladen
• Batch: drei unabhängige kreative Varianten anstelle einer überladenen Multi-Cut-Generierung

Halten Sie jede Seedance-Aufgabe zwischen 4 und 15 Sekunden. Planen Sie für eine 20–30-Sekunden-Anzeige zwei oder drei eigenständig gültige Clips und montieren Sie diese erst, nachdem jeder Clip die Qualitätskontrolle bestanden hat.

Workflow

1. Erstellen eines fundierten Produktbriefs

Sammeln oder schließen Sie nur sichere kreative Entscheidungen ab:

• Produktname, Kategorie, URL und klare Produktbilder
• Zielkunde, Problem, Unterscheidungsmerkmal, Angebot und Call-to-Action
• Quellengestütztes Claim-Ledger und verbotene Behauptungen
• Plattform, Zielmarkt, Sprache, Dauer und Batch-Größe
• Format: unboxing-reveal, first-use-demo, direct-to-camera-demo, problem-solution, try-on oder creator-comparison
• Talentquelle: user-provided, hired-creator oder synthetic-generic
• Genehmigtes Darstellerbild, Produktbild, Erstbildplatte oder Referenzmedien

Recherchieren Sie eine bereitgestellte Produkt-URL, wenn die sichtbare Seite nicht genügend Informationen enthält. Bevorzugen Sie die offizielle Produktseite, das Produkthandbuch, die verifizierte Händlerliste und die aktuellen offiziellen Richtlinien. Trennen Sie recherchierte Fakten von kreativer Inszenierung.

Kopieren Sie assets/ugc-brief.example.json in den Arbeitsbereich der Aufgabe und ersetzen Sie die Demo-Werte. Halten Sie den genauen gesprochenen Satz sowohl in creative.script als auch in creative.seedance_prompt.

Führen Sie aus:

node scripts/validate-ugc-brief.mjs /absoluter/pfad/zu/ugc-brief.json

Beheben Sie jeden Fehler vor der Generierung. Behandeln Sie Warnungen als explizite Prüfpunkte.

2. Wählen Sie einen kreativen Ansatz

Lesen Sie references/ugc-playbook.md bei der Auswahl von Formaten, Beat-Timing, Authentizitätssignalen, Batch-Varianten oder Plattformanpassungen.

Wählen Sie ein Versprechen pro Anzeige. Bevorzugen Sie eine sichtbare Produkthandlung vor Adjektiven:

• Verpacken Sie ein Paket aus
• Tragen Sie das Produkt einmal auf oder verwenden Sie es einmal
• Zeigen Sie ein Bedienelement oder eine Funktion
• Vergleichen Sie einen Vorher/Nachher-Zustand nur, wenn echte Beweise vorliegen
• Nennen Sie einen Vorteil und einen Call-to-Action

Verwenden Sie einen gesprochenen Hook, keinen generierten Overlay-Text. Heben Sie den optionalen kurzen Hook-Overlay und die Untertitel für die Nachbearbeitung auf.

Für einen Kampagnen-Batch variieren Sie immer nur eine Dimension:

• Hook A: Schmerzerkennung
• Hook B: unerwartete Entdeckung
• Hook C: produktzentrierte visuelle Enthüllung

Halten Sie die Produktfakten, das Angebot, die Nutzungsrechte des Talents und den Call-to-Action über den Batch hinweg konsistent.

3. Schreiben für natürliche Sprache

Verwenden Sie Kontraktionen, Pausen, Selbstkorrekturen und einfache Wörter, die zum Zielmarkt passen. Vermeiden Sie polierte Brand-Copy-Kadenz.

Verwenden Sie diese Sprechbudgets:

• Englisch: etwa 2.0–2.8 Wörter pro Sekunde
• Chinesisch: etwa 3.5–5.0 gesprochene Zeichen pro Sekunde

Bauen Sie eine 10-Sekunden-Anzeige mit dieser Standard-Beat-Map:

1. 0.0–1.5s — gesprochener oder visueller Hook; Produkt bereits sichtbar
2. 1.5–4.0s — auspacken, auftragen, tragen oder das Produkt näher bringen
3. 4.0–8.0s — eine belegte Funktion oder ein sichtbares Ergebnis demonstrieren
4. 8.0–10.0s — natürliche Reaktion und ein Call-to-Action

Behaupten Sie nicht „Ich habe dies seit Wochen benutzt“, „dies hat geheilt“, „alle lieben“ oder eine gleichwertige Erfahrungs-/Ergebnisformulierung, es sei denn, das Claim-Ledger unterstützt dies und das Talent ist befugt, es zu sagen.

4. Wählen Sie den Seedance-Medienmodus

Verwenden Sie genau einen Modus:

1. Erstbildplatte — beste Kontrolle. Verwenden Sie ein verifiziertes 9:16-Bild, das bereits das genehmigte Talent mit dem exakten Produkt zeigt. Übergeben Sie es als production.first_frame_url oder production.first_frame_path.
2. Multimodale Referenzen — verwenden Sie separate genehmigte Darsteller- und Produktbilder. Platzieren Sie sie in production.reference_image_urls oder production.reference_image_paths.
3. Nur Text — nur für generische Konzeptentwürfe. Warnen Sie, dass Produkt-, Verpackungs- und Talenttreue geringer sein werden.

Mischen Sie keine Erst-/Letztbild-Eingaben mit multimodalen Referenzen. Halten Sie die Darstelleridentität, Produktgeometrie, Verpackungsfarben, Verschlussausrichtung, Etikettenplatzierung und genehmigte Kleidung stabil.

Wenn zuerst eine Heldenplatte erstellt werden muss, verwenden Sie ein verfügbares Bildbearbeitungs-Skill mit den Darsteller- und Produktreferenzen und überprüfen Sie das Bild in nativer Auflösung visuell, bevor Sie Seedance aufrufen. Akzeptieren Sie keine Platte mit mutierter Verpackung, erfundenem Text, zusätzlichen Fingern oder einem veränderten Gesicht.

5. Regie für die Darbietung

Stellen Sie sicher, dass der Seedance-Prompt Folgendes enthält:

• exakte Dauer, 9:16 und One-Shot- oder Clip-Topologie
• exakten genehmigten Dialog in Anführungszeichen
• Startposition des Produkts und eine dominante physische Aktion pro Beat
• entspannte Blickrichtung, kleine Handgesten, natürliches Blinzeln, Atem und Mikro-Pausen
• Gefühl von Handykamera, leichte Autofokus-/Belichtungsschwankungen, realistische Hauttextur, gewöhnliches Raumlicht und dezente Hintergrunddetails
• nützliche native Geräusche: Dialog, Raumklang, Verpackungsrisse/-klicks oder Produktgebrauchsgeräusche
• negative Einschränkungen: keine Schnitte außer geplant, kein Beauty-Filter, kein Abdriften des Darstellers, keine Produktmutation, kein Duplikatprodukt, kein erfundenes Etikett, keine zusätzlichen Finger, kein nicht zusammenhängendes Logo, keine Untertitel, kein Wasserzeichen

Vermeiden Sie „kinoreife Werbung“, perfekte Symmetrie, luxuriöses Studiolicht, aggressive Kamerafahrten oder Model-Posen, es sei denn, der Brief fordert explizit eine polierte Hybrid-Anzeige.

6. Führen Sie einen Trockentest mit der echten Payload durch

Lokalisieren Sie das installierte benachbarte Skill in dieser Reihenfolge:

• ~/.codex/skills/hiapi-seedance-2-0-video-skill
• ~/.codex/skills/hiapi-seedance-2-0-video
• HIAPI_SEEDANCE_SKILL_DIR wenn explizit konfiguriert

Führen Sie das Wrapper-Skript aus diesem Skills-Verzeichnis aus:

node scripts/run-ugc-seedance.mjs /absoluter/pfad/zu/ugc-brief.json --dry-run

Der Wrapper importiert den getesteten Payload-Builder des benachbarten Skills. Er konvertiert lokale Medienpfade innerhalb von Node in Data-URIs, sodass große Referenzen nicht über Shell-Argumente übergeben werden. Überprüfen Sie die geschwärzte Payload und bestätigen Sie:

• model ist seedance-2.0
• duration ist 4–15
• ratio ist 9:16
• resolution ist beabsichtigt
• generate_audio stimmt mit dem Brief überein
• genau ein Medienmodus ist vorhanden
• nur genehmigte Referenzen sind vorhanden

7. Nur auf Anfrage generieren

Fordern Sie für eine tatsächliche Videoanfrage HIAPI_API_KEY in der Umgebung, und führen Sie dann aus:

node scripts/run-ugc-seedance.mjs /absoluter/pfad/zu/ugc-brief.json

Wenn der Benutzer nur nach Konzepten, Skripten, Prompts oder einem Produktionsplan fragt, stoppen Sie vor diesem Befehl und geben Sie den vollständigen Brief zurück.

Für einen Batch verwenden Sie einen Brief pro Variante und bewahren Sie eine stabile Kampagnen-ID sowie ein Variantenlabel. Ändern Sie den beabsichtigten Ansatz; ändern Sie nicht stillschweigend die Produktbehauptungen. Das aktuelle HiAPI Seedance 2.0-Aufgabenschema akzeptiert keinen clientseitigen seed.

Der Runner gibt die HiAPI-Aufgaben-ID unmittelbar nach der Aufgabenerstellung aus. Wenn die Abfrage oder der Download durch einen vorübergehenden Netzwerkfehler unterbrochen wird, setzen Sie genau diese Aufgabe fort, anstatt ein Duplikat zu erstellen und zu berechnen:

node scripts/run-ugc-seedance.mjs /absoluter/pfad/zu/ugc-brief.json \
  --resume-task-id "tk-hiapi-..."

8. Überprüfen des Artefakts

Schließen Sie niemals von einer akzeptierten Anfrage oder Aufgaben-ID auf Erfolg.

Nach dem Download:

1. Untersuchen Sie die MP4 mit ffprobe; notieren Sie Dauer, Abmessungen, Bildrate, Codecs und Audio-Präsenz.
2. Extrahieren Sie die Eröffnungs-, Demonstrations- und Schlussframes.
3. Überprüfen Sie Gesichtsidentität, Hände, Mund, Produktgeometrie, Verpackung, Etikett, Produktanzahl und Hintergrundkontinuität.
4. Hören Sie das gesamte Audio oder transkribieren Sie es. Überprüfen Sie exakte Sprache, Verständlichkeit, Lippenbewegungen, Produktgeräusche und den vollständigen Call-to-Action.
5. Lehnen Sie Ausgaben ab, die erfundenen Text, abgeschnittene Sprache, Gesichtsdrift, deformierte Hände, Produktmutation, Offenlegungskonflikte oder eine fehlende sichtbare Demonstration aufweisen.
6. Fügen Sie Plattformuntertitel, Safe-Zone-Text, Musik oder CTA-Overlays erst hinzu, nachdem die Rohgeneration bestanden ist.

Wenn ein schwerwiegender Produkt- oder Abbildungsfehler auftritt, generieren Sie von einer sauberen Referenzplatte aus neu oder vereinfachen Sie die Aktion. Verbergen Sie einen wesentlichen Fehler nicht durch Zuschneiden.

Ausgabe-Vertrag

Geben Sie diese Abschnitte in der Sprache des Benutzers zurück:

1. Annahmen
2. Produktquellen und Claim-Ledger
3. Gewähltes UGC-Format und Zielgruppenansatz
4. Hook-Varianten
5. Abschlussskript mit Zeit-Beats
6. Referenz-Asset-Plan
7. Copy-Ready Seedance-Prompt
8. Validierte Payload oder exakter Ausführungsbefehl
9. Compliance- und Offenlegungshinweise
10. QC-Ergebnisse
11. Artefaktpfade — nur wenn echte Dateien existieren

Unterscheiden Sie bei einem generierten Ergebnis zwischen created, still processing, failed und downloaded. Sagen Sie niemals „beendet“ ohne eine echte lokale Datei oder eine verifizierte entfernte Ergebnis-URL.

Ressourcen

• Lesen Sie references/ugc-playbook.md zur Formatwahl, Timing, Prompt-Mustern, Batch-Design und Qualitätskontrolle.
• Lesen Sie references/github-foundations.md, wenn Sie die Open-Source-Basis des Skills prüfen oder aktualisieren.
• Kopieren Sie assets/ugc-brief.example.json als maschinell prüfbaren Brief.
• Führen Sie scripts/validate-ugc-brief.mjs vor jeder kostenpflichtigen Generierung aus.
• Führen Sie scripts/run-ugc-seedance.mjs für Payload-Trockentests und echte HiAPI-Ausführung aus.