Que fait HiAPI Seedance 2.0 Vidéo Publicitaire UGC ?
Créez des publicités produit verticales qui donnent l'impression qu'un créateur présente authentiquement un produit, tout en gardant chaque allégation produit, chaque ressemblance et chaque artefact de sortie auditable.
Réutilisez l'implémentation installée hiapi-seedance-2-0-video pour la validation de la charge utile, la soumission des tâches, l'interrogation et le téléchargement. Ne réécrivez pas le transport HiAPI. Cette compétence ajoute les couches de recherche UGC, de script, d'actifs de référence, de variantes de campagne et de contrôle qualité.
Barrières strictes
- Utilisez l'image d'une personne réelle uniquement si l'utilisateur l'a fournie ou a identifié un actif approuvé et confirmé l'autorisation d'utiliser cette ressemblance. N'imitez pas une célébrité, une personnalité publique, un client ou un créateur pour une approbation.
- Identifiez un acteur généré comme synthétique dans le brief. Ne présentez pas une performance synthétique comme un témoignage client non scénarisé.
- Basez les avantages, spécifications, prix, réductions, comparaisons et résultats sur les supports de l'utilisateur ou des sources primaires actuelles. N'inventez pas d'avis, d'historique d'utilisation, de résultats avant/après, de rareté ou d'expérience personnelle.
- Traitez les catégories santé, médicale, compléments alimentaires, perte de poids, finance, alcool, jeux d'argent et autres catégories réglementées comme nécessitant une révision. Vérifiez les règles officielles actuelles de la plateforme et de la juridiction avant de produire le texte publicitaire final.
- Ne placez pas de texte, d'étiquettes, de prix ou de badges non vérifiés à l'intérieur de la vidéo générée. Ajoutez les légendes et le texte de l'offre en post-production uniquement après avoir vérifié l'audio parlé.
- Ne publiez, ne planifiez et ne téléchargez pas publiquement à moins que l'utilisateur ne le demande explicitement comme action distincte.
- Ne générez pas en
4ket n'utilisez pas de stockage persistant payant sans confirmation explicite des coûts.
Valeurs par défaut
Utilisez ces valeurs lorsque la requête ne les spécifie pas :
- Plateformes : TikTok et Instagram Reels
- Format d'image :
9:16 - Durée :
10secondes - Résolution :
720ppour un brouillon ; utilisez1080plorsque l'utilisateur demande une qualité de livraison - Audio : dialogue natif Seedance activé
- Structure : un plan continu tenu à la main avec quatre micro-séquences
- Langue : correspond à l'utilisateur ou au marché cible qu'il nomme
- Stockage : sortie temporaire, téléchargée localement
- Lot : trois variantes créatives indépendantes plutôt qu'une génération multi-coupes surchargée
Gardez chaque tâche Seedance entre 4 et 15 secondes. Pour une publicité de 20 à 30 secondes, planifiez deux ou trois clips indépendamment valides et assemblez-les uniquement après que chaque clip ait passé le contrôle qualité.
Flux de travail
1. Construire un brief produit sourcé
Collectez ou déduisez uniquement les choix créatifs sûrs :
- nom du produit, catégorie, URL et images claires du produit
- acheteur cible, problème, différenciateur, offre et appel à l'action
- registre des allégations sourcées et allégations interdites
- plateforme, marché cible, langue, durée et taille du lot
- format :
deballage-revelation,premiere-utilisation-demo,demo-face-camera,probleme-solution,essayageoucomparaison-createur - source du talent :
fourni-par-utilisateur,createur-embaucheousynthetique-generique - image approuvée de l'acteur, image du produit, première image de référence ou médias de référence
Recherchez une URL de produit fournie lorsque la page visible ne contient pas suffisamment d'informations. Préférez la page produit officielle, le manuel du produit, l'annonce du marchand vérifié et les politiques officielles actuelles. Séparez les faits sourcés de la mise en scène créative.
Copiez assets/ugc-brief.example.json dans l'espace de travail de la tâche et remplacez les valeurs de démonstration. Conservez la ligne parlée exacte à la fois dans creative.script et creative.seedance_prompt.
Exécutez :
node scripts/validate-ugc-brief.mjs /chemin/absolu/vers/ugc-brief.json
Corrigez chaque erreur avant la génération. Traitez les avertissements comme des éléments de révision explicites.
2. Choisir un angle créatif
Lisez references/ugc-playbook.md lors de la sélection des formats, du timing des séquences, des signaux d'authenticité, des variantes de lot ou des adaptations de plateforme.
Choisissez une promesse par publicité. Préférez une action produit visible aux adjectifs :
- déballer un emballage
- appliquer ou utiliser le produit une fois
- montrer une commande ou une fonctionnalité
- comparer un état avant/après uniquement si des preuves réelles existent
- nommer un avantage et un appel à l'action
Utilisez un accroche parlée, pas un texte de superposition généré. Réservez la superposition optionnelle de l'accroche courte et les légendes pour la post-production.
Pour un lot de campagne, variez une dimension à la fois :
- Accroche A : reconnaissance de la douleur
- Accroche B : découverte inattendue
- Accroche C : révélation visuelle centrée sur le produit
Gardez les faits produit, l'offre, les droits du talent et l'appel à l'action cohérents dans tout le lot.
3. Écrire pour un discours naturel
Écrivez des contractions, des pauses, des auto-corrections et des mots simples adaptés au marché cible. Évitez le rythme léché du copywriting de marque.
Utilisez ces budgets de parole :
- Anglais : visez environ
2,0–2,8mots par seconde - Chinois : visez environ
3,5–5,0caractères parlés par seconde
Construisez une publicité de 10 secondes avec cette carte de séquences par défaut :
0,0–1,5s— accroche parlée ou visuelle ; produit déjà visible1,5–4,0s— déballer, appliquer, porter ou rapprocher le produit4,0–8,0s— démontrer une caractéristique sourcée ou un résultat visible8,0–10,0s— réaction naturelle et un appel à l'action
N'affirmez pas « J'utilise cela depuis des semaines », « cela a guéri », « tout le monde adore » ou un langage équivalent d'expérience/résultat à moins que le registre des allégations ne le soutienne et que le talent soit autorisé à le dire.
4. Choisir le mode média Seedance
Utilisez exactement un mode :
- Première image de référence — le meilleur contrôle. Utilisez une image 9:16 vérifiée montrant déjà le talent approuvé avec le produit exact. Passez-la comme
production.first_frame_urlouproduction.first_frame_path. - Références multimodales — utilisez des images séparées de l'acteur et du produit approuvés. Placez-les dans
production.reference_image_urlsouproduction.reference_image_paths. - Texte uniquement — à utiliser uniquement pour des brouillons de concept génériques. Prévenez que la fidélité du produit, de l'emballage et du talent sera inférieure.
Ne mélangez pas les entrées première/dernière image avec les références multimodales. Gardez l'identité de l'acteur, la géométrie du produit, les couleurs de l'emballage, l'orientation du capuchon, le placement des étiquettes et la garde-robe approuvée stables.
Si une image héroïque doit d'abord être créée, utilisez une compétence de retouche d'image disponible avec les références de l'acteur et du produit, puis inspectez visuellement l'image en résolution native avant d'appeler Seedance. N'acceptez pas une image avec un emballage modifié, du texte fabriqué, des doigts supplémentaires ou un visage altéré.
5. Diriger la performance
Incluez dans le prompt Seedance :
- durée exacte,
9:16et topologie de plan unique ou de clips - dialogue approuvé exact entre guillemets
- position de départ du produit et une action physique dominante par séquence
- ligne de regard détendue, petits gestes des mains, clignements naturels, respiration et micro-pauses
- sensation de téléphone tenu à la main, léger souffle d'autofocus/exposition, texture de peau réaliste, lumière ambiante ordinaire et arrière-plan modeste
- son natif utile : dialogue, son ambiant, bruit de déchirure/clic d'emballage ou son d'utilisation du produit
- contraintes négatives : pas de coupures sauf si planifiées, pas de filtre de beauté, pas de dérive de l'acteur, pas de mutation du produit, pas de produit en double, pas de texte d'étiquette inventé, pas de doigts supplémentaires, pas de logo non lié, pas de sous-titres, pas de filigrane
Évitez « commercial cinématographique », symétrie parfaite, éclairage de studio de luxe, mouvements de chariot agressifs ou poses de mannequin, sauf si le brief demande explicitement une publicité hybride soignée.
6. Exécuter à sec la charge utile réelle
Localisez la compétence adjacente installée dans cet ordre :
~/.codex/skills/hiapi-seedance-2-0-video-skill~/.codex/skills/hiapi-seedance-2-0-videoHIAPI_SEEDANCE_SKILL_DIRlorsqu'il est explicitement configuré
Exécutez le wrapper depuis ce répertoire de compétence :
node scripts/run-ugc-seedance.mjs /chemin/absolu/vers/ugc-brief.json --dry-run
Le wrapper importe le constructeur de charge utile testé de la compétence adjacente. Il convertit les chemins de médias locaux en URI de données dans Node, de sorte que les grandes références ne soient pas transmises via les arguments du shell. Passez en revue la charge utile expurgée et confirmez :
- le modèle est
seedance-2.0 - la durée est
4–15 - le format est
9:16 - la résolution est celle prévue
generate_audiocorrespond au brief- exactement un mode média est présent
- seules les références approuvées sont présentes
7. Générer uniquement sur demande
Pour une demande de vidéo réelle, exigez HIAPI_API_KEY dans l'environnement, puis exécutez :
node scripts/run-ugc-seedance.mjs /chemin/absolu/vers/ugc-brief.json
Si l'utilisateur demande uniquement des concepts, des scripts, des prompts ou un plan de production, arrêtez-vous avant cette commande et retournez le brief complet.
Pour un lot, utilisez un brief par variante et conservez un ID de campagne stable ainsi qu'un libellé de variante. Changez l'angle prévu ; ne modifiez pas silencieusement les allégations produit. Le schéma de tâche actuel de HiAPI Seedance 2.0 n'accepte pas de seed fourni par le client.
L'exécuteur imprime l'ID de tâche HiAPI immédiatement après la création de la tâche. Si l'interrogation ou le téléchargement est interrompu par une erreur réseau transitoire, reprenez cette tâche exacte au lieu d'en créer et de facturer une copie :
node scripts/run-ugc-seedance.mjs /chemin/absolu/vers/ugc-brief.json \
--resume-task-id "tk-hiapi-..."
8. Vérifier l'artefact
Ne déduisez jamais le succès d'une requête acceptée ou d'un ID de tâche.
Après le téléchargement :
- Sondez le MP4 avec
ffprobe; enregistrez la durée, les dimensions, la fréquence d'images, les codecs et la présence audio. - Extrayez les images d'ouverture, de démonstration et finales.
- Inspectez l'identité du visage, les mains, la bouche, la géométrie du produit, l'emballage, l'étiquette, le nombre de produits et la continuité de l'arrière-plan.
- Écoutez l'audio complet ou retranscrivez-le. Vérifiez la langue exacte, l'intelligibilité, la synchronisation labiale, les sons du produit et l'appel à l'action complet.
- Rejetez les sorties avec du texte fabriqué, un discours tronqué, une dérive du visage, des mains déformées, une mutation du produit, des conflits de divulgation ou une démonstration visible manquante.
- Ajoutez des légendes de plateforme, du texte en zone de sécurité, de la musique ou des superpositions d'appel à l'action uniquement après que la génération brute a réussi.
En cas d'échec de base du produit ou de la ressemblance, régénérez à partir d'une image de référence plus propre ou simplifiez l'action. Ne masquez pas un échec matériel par un recadrage.
Contrat de sortie
Retournez ces sections dans la langue de l'utilisateur :
- Hypothèses
- Sources produit et registre des allégations
- Format UGC choisi et angle d'audience
- Variantes d'accroche
- Script final avec séquences temporelles
- Plan des actifs de référence
- Prompt Seedance prêt à copier
- Charge utile validée ou commande d'exécution exacte
- Notes de conformité et de divulgation
- Résultats du contrôle qualité
- Chemins des artefacts — uniquement après que les fichiers réels existent
Pour un résultat généré, distinguez créé, encours de traitement, échoué et téléchargé. Ne dites jamais « terminé » sans un fichier local réel ou une URL de résultat distant vérifié.
Ressources
- Lisez
references/ugc-playbook.mdpour la sélection du format, le timing, les modèles de prompt, la conception de lots et le contrôle qualité. - Lisez
references/github-foundations.mdlors de l'audit ou de la mise à jour de la base open source de la compétence. - Copiez
assets/ugc-brief.example.jsoncomme brief vérifiable par machine. - Exécutez
scripts/validate-ugc-brief.mjsavant chaque génération payante. - Exécutez
scripts/run-ugc-seedance.mjspour les exécutions à sec de charge utile et l'exécution réelle HiAPI.