HiAPI Seedance 2.0 UGC Ad Video

HiAPI Seedance 2.0 UGC Ad Video (Vídeo de Anúncio UGC HiAPI Seedance 2.0)

Crie anúncios verticais de produtos que pareçam ter sido feitos por um criador demonstrando o produto genuinamente, mantendo cada alegação de produto, semelhança e artefato de saída auditável.

Reutilize a implementação instalada de hiapi-seedance-2-0-video para validação de payload, submissão de tarefas, polling e download. Não reescreva o transporte HiAPI. Esta skill adiciona as camadas de pesquisa UGC, roteirização, assets de referência, variantes de campanha e controle de qualidade.

Portões (Gates) Rigorosos

• Use a imagem de uma pessoa real somente quando o usuário a forneceu, identificou um asset aprovado e confirmou a permissão para usar aquela semelhança. Não imite o endosso de uma celebridade, figura pública, cliente ou criador.
• Identifique um ator gerado como sintético no briefing. Não apresente uma performance sintética como um depoimento de cliente não roteirizado.
• Baseie benefícios, especificações, preços, descontos, comparações e resultados nos materiais do usuário ou fontes primárias atuais. Não invente avaliações, histórico de uso, resultados de antes/depois, escassez ou experiência pessoal.
• Trate categorias regulamentadas como saúde, médicos, suplementos, perda de peso, finanças, álcool, jogos de azar e outras como exigindo revisão. Verifique as regras oficiais atuais da plataforma e jurisdição antes de produzir o texto final do anúncio.
• Não coloque texto, rótulos, preços ou selos não verificados dentro do vídeo gerado. Adicione legendas e texto de oferta apenas na pós-produção, após verificar o áudio falado.
• Não publique, agende ou envie publicamente a menos que o usuário peça explicitamente por essa ação separada.
• Não gere em 4k ou use armazenamento persistente pago sem confirmação explícita de custo.

Padrões (Defaults)

Use estes quando a solicitação não os especificar:

• Plataformas: TikTok e Instagram Reels
• Proporção de tela: 9:16
• Duração: 10 segundos
• Resolução: 720p para um rascunho; use 1080p quando o usuário solicitar qualidade de entrega
• Áudio: Diálogo nativo Seedance habilitado
• Estrutura: um único take contínuo com câmera na mão e quatro micro-batidas
• Idioma: corresponder ao usuário ou ao mercado-alvo que ele nomear
• Armazenamento: saída temporária, baixada localmente
• Lote: três variantes criativas independentes, em vez de uma única geração sobrecarregada com múltiplos cortes

Mantenha cada tarefa Seedance entre 4 e 15 segundos. Para um anúncio de 20 a 30 segundos, planeje dois ou três clipes independentemente válidos e monte-os somente após cada clipe passar no controle de qualidade.

Fluxo de Trabalho (Workflow)

1. Construir um briefing de produto fundamentado

Colete ou infira apenas escolhas criativas seguras:

• nome do produto, categoria, URL e imagens claras do produto
• comprador-alvo, problema, diferencial, oferta e CTA (chamada para ação)
• registro de alegações com origem e alegações proibidas
• plataforma, mercado-alvo, idioma, duração e tamanho do lote
• formato: unboxing-reveal (revelação de unboxing), first-use-demo (demo de primeiro uso), direct-to-camera-demo (demo direto para a câmera), problem-solution (problema-solução), try-on (experimentação) ou creator-comparison (comparação de criador)
• origem do talento: user-provided (fornecido pelo usuário), hired-creator (criador contratado) ou synthetic-generic (sintético genérico)
• imagem do ator aprovado, imagem do produto, primeira moldura (plate) ou mídia de referência

Pesquise uma URL de produto fornecida quando a página visível não contiver informações suficientes. Prefira a página oficial do produto, o manual do produto, a listagem do comerciante verificado e as políticas oficiais atuais. Separe os fatos obtidos da encenação criativa.

Copie assets/ugc-brief.example.json para o espaço de trabalho da tarefa e substitua os valores de demonstração. Mantenha a linha de fala exata tanto em creative.script quanto em creative.seedance_prompt.

Execute:

node scripts/validate-ugc-brief.mjs /caminho/absoluto/para/ugc-brief.json

Corrija todos os erros antes da geração. Trate os avisos como itens explícitos de revisão.

2. Escolher um ângulo criativo

Leia references/ugc-playbook.md ao selecionar formatos, temporização de batidas, sinais de autenticidade, variantes de lote ou adaptações de plataforma.

Escolha uma promessa por anúncio. Prefira uma ação visível do produto a adjetivos:

• desembalar um pacote
• aplicar ou usar o produto uma vez
• mostrar um controle ou recurso
• comparar um estado antes/depois apenas quando houver evidência real
• nomear um benefício e um CTA

Use um gancho (hook) falado, não texto sobreposto gerado. Salve o gancho curto opcional sobreposto e as legendas para a pós-produção.

Para um lote de campanha, varie uma dimensão de cada vez:

• Gancho A: reconhecimento da dor
• Gancho B: descoberta inesperada
• Gancho C: revelação visual primeiro do produto

Mantenha os fatos do produto, oferta, direitos do talento e CTA consistentes em todo o lote.

3. Escrever para fala natural

Escreva contrações, pausas, autocorreções e palavras simples que se encaixem no mercado-alvo. Evite cadência polida de copy de marca.

Use estes orçamentos de fala:

• Inglês: mire cerca de 2.0–2.8 palavras por segundo
• Chinês: mire cerca de 3.5–5.0 caracteres falados por segundo

Construa um anúncio de 10 segundos com este mapa de batidas padrão:

1. 0.0–1.5s — gancho falado ou visual; produto já visível
2. 1.5–4.0s — desembale, aplique, vista ou aproxime o produto
3. 4.0–8.0s — demonstre um recurso com origem ou resultado visível
4. 8.0–10.0s — reação natural e um CTA

Não afirme "Usei isso por semanas", "isso curou", "todo mundo adora" ou linguagem equivalente de experiência/resultado, a menos que o registro de alegações suporte e o talento esteja autorizado a dizê-lo.

4. Escolher o modo de mídia Seedance

Use exatamente um modo:

1. Primeira moldura (First-frame plate) — melhor controle. Use uma imagem 9:16 verificada já mostrando o talento aprovado com o produto exato. Passe como production.first_frame_url ou production.first_frame_path.
2. Referências multimodais — use imagens separadas do ator e do produto aprovados. Coloque-as em production.reference_image_urls ou production.reference_image_paths.
3. Apenas texto — use apenas para rascunhos de conceito genéricos. Avise que a fidelidade do produto, embalagem e talento será menor.

Não misture entradas de primeira/última moldura com referências multimodais. Mantenha a identidade do ator, geometria do produto, cores da embalagem, orientação da tampa, posição do rótulo e guarda-roupa aprovado estáveis.

Se uma moldura principal (hero plate) precisar ser criada primeiro, use uma skill de edição de imagem disponível com as referências do ator e produto, depois inspecione visualmente a imagem em resolução nativa antes de chamar o Seedance. Não aceite uma moldura com embalagem mutada, texto fabricado, dedos extras ou rosto alterado.

5. Dirigir a performance

Faça o prompt Seedance incluir:

• duração exata, 9:16 e topologia de um take ou clipe
• diálogo aprovado exato entre aspas
• posição inicial do produto e uma ação física dominante por batida
• linha de olhar relaxada, pequenos gestos com as mãos, piscadas naturais, respiração e micropausas
• sensação de câmera de celular na mão, leve respiração de foco/exposição automáticos, textura de pele realista, luz ambiente comum e detalhes modestos de fundo
• som nativo útil: diálogo, ruído ambiente, rasgo/clique de embalagem ou som de uso do produto
• restrições negativas: sem cortes a menos que planejados, sem filtro de beleza, sem desvio do ator, sem mutação do produto, sem produto duplicado, sem texto de rótulo inventado, sem dedos extras, sem logotipo não relacionado, sem legendas, sem marca d'água

Evite "comercial cinematográfico", simetria perfeita, iluminação de estúdio de luxo, movimentos agressivos de dolly ou poses de modelo, a menos que o briefing peça explicitamente um anúncio híbrido polido.

6. Testar o payload real (Dry-run)

Localize a skill adjacente instalada nesta ordem:

• ~/.codex/skills/hiapi-seedance-2-0-video-skill
• ~/.codex/skills/hiapi-seedance-2-0-video
• HIAPI_SEEDANCE_SKILL_DIR quando configurado explicitamente

Execute o wrapper a partir do diretório desta skill:

node scripts/run-ugc-seedance.mjs /caminho/absoluto/para/ugc-brief.json --dry-run

O wrapper importa o construtor de payload testado da skill adjacente. Ele converte caminhos de mídia locais em URIs de dados dentro do Node, para que grandes referências não sejam passadas por argumentos de shell. Revise o payload editado e confirme:

• model é seedance-2.0
• duration é 4–15
• ratio é 9:16
• resolution é a pretendida
• generate_audio corresponde ao briefing
• exatamente um modo de mídia está presente
• apenas referências aprovadas estão presentes

7. Gerar apenas quando solicitado

Para uma solicitação de vídeo real, exija HIAPI_API_KEY no ambiente, depois execute:

node scripts/run-ugc-seedance.mjs /caminho/absoluto/para/ugc-brief.json

Se o usuário pedir apenas conceitos, roteiros, prompts ou um plano de produção, pare antes deste comando e retorne o briefing completo.

Para um lote, use um briefing por variante e preserve um ID de campanha estável mais o rótulo da variante. Mude o ângulo pretendido; não mude silenciosamente as alegações do produto. O esquema atual de tarefa HiAPI Seedance 2.0 não aceita uma seed fornecida pelo cliente.

O executor imprime o ID da tarefa HiAPI imediatamente após a criação da tarefa. Se o polling ou download for interrompido por um erro de rede transitório, retome essa tarefa exata em vez de criar e cobrar por uma duplicata:

node scripts/run-ugc-seedance.mjs /caminho/absoluto/para/ugc-brief.json \
  --resume-task-id "tk-hiapi-..."

8. Verificar o artefato

Nunca infira sucesso a partir de uma solicitação aceita ou ID de tarefa.

Após o download:

1. Analise o MP4 com ffprobe; registre duração, dimensões, taxa de quadros, codecs e presença de áudio.
2. Extraia os quadros de abertura, demonstração e finais.
3. Inspecione identidade facial, mãos, boca, geometria do produto, embalagem, rótulo, quantidade de produto e continuidade de fundo.
4. Ouça o áudio completo ou transcreva-o. Verifique idioma exato, inteligibilidade, sincronia labial, sons do produto e o CTA completo.
5. Rejeite saídas com texto fabricado, fala cortada, desvio facial, mãos deformadas, mutação do produto, conflitos de divulgação ou uma demonstração visível ausente.
6. Adicione legendas da plataforma, texto de zona segura, música ou sobreposições de CTA somente depois que a geração bruta passar.

Se qualquer falha central de produto ou semelhança aparecer, regenere a partir de uma moldura de referência mais limpa ou simplifique a ação. Não esconda uma falha material com corte (crop).

Contrato de Saída (Output Contract)

Retorne estas seções no idioma do usuário:

1. Suposições (Assumptions)
2. Fontes do Produto e Registro de Alegações (Product Sources and Claim Ledger)
3. Formato UGC e Ângulo de Público Escolhidos (Chosen UGC Format and Audience Angle)
4. Variantes de Gancho (Hook Variants)
5. Roteiro Final com Tempos de Batida (Final Script with Time Beats)
6. Plano de Assets de Referência (Reference Asset Plan)
7. Prompt Seedance Pronto para Cópia (Copy-Ready Seedance Prompt)
8. Payload Validado ou Comando de Execução Exato (Validated Payload or Exact Run Command)
9. Notas de Conformidade e Divulgação (Compliance and Disclosure Notes)
10. Resultados do Controle de Qualidade (QC Results)
11. Caminhos dos Artefatos (Artifact Paths) — apenas após os arquivos reais existirem

Para um resultado gerado, distinga criado (created), ainda processando (still processing), falhou (failed) e baixado (downloaded). Nunca diga "finalizado" sem um arquivo local real ou URL de resultado remoto verificado.

Recursos (Resources)

• Leia references/ugc-playbook.md para seleção de formato, temporização, padrões de prompt, design de lote e controle de qualidade.
• Leia references/github-foundations.md ao auditar ou atualizar a base de código aberto da skill.
• Copie assets/ugc-brief.example.json como o briefing verificável por máquina.
• Execute scripts/validate-ugc-brief.mjs antes de cada geração paga.
• Execute scripts/run-ugc-seedance.mjs para execuções de teste (dry-run) e execução real do HiAPI.