Communitygithub.com

HiAPI Seedance 2.0 Vidéo Publicitaire UGC

Créez des publicités produit verticales, ancrées dans des sources fiables, mettant en scène des personnes réelles ou des acteurs synthétiques consentis, avec HiAPI Seedance 2.0 pour TikTok et Instagram Reels.

Qu'est-ce que HiAPI Seedance 2.0 Vidéo Publicitaire UGC ?

Cette compétence permet de générer des publicités produit au format UGC (contenu généré par l'utilisateur) qui semblent authentiques, comme si un créateur présentait le produit de manière naturelle. Elle s'appuie sur l'implémentation `hiapi-seedance-2-0-video` pour la validation des charges utiles, la soumission des tâches, l'interrogation et le téléchargement, sans réécrire le transport HiAPI. La compétence ajoute des couches de recherche UGC, de script, d'actifs de référence, de variantes de campagne et de contrôle qualité. Elle est conçue pour les e-commerçants, les spécialistes du marketing et les créateurs qui souhaitent produire des essais produits, des déballages, des démonstrations face caméra, des scripts de type créateur, des variantes pour les réseaux sociaux payants, des vidéos 9:16 ou des campagnes UGC par lots, le tout avec des contrôles stricts sur les allégations, les droits à l'image et la conformité réglementaire. Le flux de travail comprend la construction d'un brief produit sourcé, le choix d'un angle créatif, l'écriture d'un dialogue naturel, la sélection du mode média Seedance, la direction de la performance, l'exécution à sec de la charge utile, la génération sur demande et la vérification complète de l'artefact final. Des barrières strictes empêchent l'usurpation d'identité, les témoignages inventés, l'utilisation de contenu réglementé sans examen, et la publication non autorisée. Les valeurs par défaut incluent le format 9:16, une durée de 10 secondes, une résolution 720p pour les brouillons (1080p pour la livraison), l'audio natif Seedance, et un lot de trois variantes créatives indépendantes.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/HiAPIAI/hiapi-product-video-skills/tree/main/skills/ugc-ad

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 4k et 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 : 10 secondes
  • Résolution : 720p pour un brouillon ; utilisez 1080p lorsque 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, essayage ou comparaison-createur
  • source du talent : fourni-par-utilisateur, createur-embauche ou synthetique-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,8 mots par seconde
  • Chinois : visez environ 3,5–5,0 caractères parlés par seconde

Construisez une publicité de 10 secondes avec cette carte de séquences par défaut :

  1. 0,0–1,5s — accroche parlée ou visuelle ; produit déjà visible
  2. 1,5–4,0s — déballer, appliquer, porter ou rapprocher le produit
  3. 4,0–8,0s — démontrer une caractéristique sourcée ou un résultat visible
  4. 8,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 :

  1. 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_url ou production.first_frame_path.
  2. Références multimodales — utilisez des images séparées de l'acteur et du produit approuvés. Placez-les dans production.reference_image_urls ou production.reference_image_paths.
  3. 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:16 et 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-video
  • HIAPI_SEEDANCE_SKILL_DIR lorsqu'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_audio correspond 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 :

  1. Sondez le MP4 avec ffprobe ; enregistrez la durée, les dimensions, la fréquence d'images, les codecs et la présence audio.
  2. Extrayez les images d'ouverture, de démonstration et finales.
  3. 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.
  4. É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.
  5. 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.
  6. 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 :

  1. Hypothèses
  2. Sources produit et registre des allégations
  3. Format UGC choisi et angle d'audience
  4. Variantes d'accroche
  5. Script final avec séquences temporelles
  6. Plan des actifs de référence
  7. Prompt Seedance prêt à copier
  8. Charge utile validée ou commande d'exécution exacte
  9. Notes de conformité et de divulgation
  10. Résultats du contrôle qualité
  11. 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.md pour 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.md lors de l'audit ou de la mise à jour de la base open source de la compétence.
  • Copiez assets/ugc-brief.example.json comme brief vérifiable par machine.
  • Exécutez scripts/validate-ugc-brief.mjs avant chaque génération payante.
  • Exécutez scripts/run-ugc-seedance.mjs pour les exécutions à sec de charge utile et l'exécution réelle HiAPI.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

hiapi-fashion-lookbook-video

Plan, preview, price, and generate short single-shot fashion videos through HiAPI. Use for runway walks, one target-outfit transition, editorial lookbook poses, and non-speaking person showcases for clothing brands, fashion creators, and ecommerce sellers. Route text-only briefs to Kling 3.0 Omni text-to-video, one authorized person or complete-look image to Kling image-to-video, and person plus garment/style references to Seedance 2.0 Fast. Do not use for exact virtual try-on or fit guarantees, multi-outfit montages, deterministic motion transfer, talking presenters, captions, logos, CTA compositing, or multi-shot editing.

hiapi-food-commercial-video

Plan, preview, price, and generate single-shot food and beverage commercial videos through HiAPI, with 3-15 second Kling output or 4-15 second Seedance Fast output. Use for coffee pours, beverage splashes, food macro shots, packaged-product hero ads, restaurant atmosphere spots, and ecommerce food promos. Route text-only requests to Kling 3.0 Omni text-to-video, one hero image to Kling image-to-video, and 1-9 reference images to Seedance 2.0 Fast. Do not use for human spokespersons, reference-motion transfer, editing, multi-shot assembly, captions, added logos, or CTA compositing.

hiapi-product-spokesperson-video

Generate product spokesperson, brand introduction, and on-camera advertising videos locally through HiAPI. Use for synthetic presenters, authorized talking-head videos from a person image, product introductions, or brand promotions from product and brand reference images. Route synthetic spokespersons to Kling 3.0 Omni text-to-video, talking heads to Kling 3.0 Omni image-to-video, and product or brand promos to Seedance 2.0 Fast. Do not use to edit or assemble existing footage.

Skills associés