Nó Cartões UGC: sincronize os cartões de captura de tela e as legendas de um vídeo UGC com a fala

Sincronize os cartões de captura de tela e as legendas de um vídeo UGC com a fala, confira se cada clipe disse a linha dele e receba Notas sobre a execução.

O nó Cartões UGC sincroniza os cartões de captura de tela e as legendas de um vídeo UGC com a fala do criador. Ele trabalha sobre o vídeo unido: os clipes do Clipe UGC, unidos pelo Combinar vídeos. Ele também verifica se cada clipe disse a linha dele e escreve as Notas.

O Cartões UGC descobre quando cada palavra é dita. A partir disso, ele define os tempos de duas coisas:

Os cartões de captura de tela. Cada captura de tela aparece enquanto o criador fala dela. Os cartões saem como um plano de camadas para o Sobreposição em vídeo.
As legendas. O plano contém a linha de abertura, onde ela termina, e as palavras com tempos do resto. As legendas saem como um plano de legendas para o Adicionar legendas. O Adicionar legendas desenha a linha de abertura com o visual Placa de abertura, e o resto no próprio estilo de legenda.

O Cartões UGC é executado só no Nodaro Cloud. Em qualquer outra instalação, todo nó UGC falha antes que algo seja reservado, com a mensagem “Os vídeos UGC são um recurso do Nodaro Cloud e não estão disponíveis nesta instância.”

Quando usar

Você juntou os clipes de um vídeo UGC e quer os cartões de captura de tela e as legendas sincronizados com a fala.
Você quer saber quais clipes renderizar de novo, a partir de frases simples sobre a execução.

Início rápido

Adicionar o nó

Pressione Tab no canvas e escolha Vídeo › Vídeo UGC › Cartões UGC.

Conectar as entradas

Conecte as saídas Texto (ajustado) e Transcrição do Clipes UGC a Texto e Transcrição. Conecte o vídeo unido do Combinar vídeos a Vídeo. Conecte a saída Vídeo do Clipe UGC a Notas dos clipes.

Conectar os planos

Conecte Plano de camadas à entrada Plano de camadas do Sobreposição em vídeo. Conecte Plano de legendas à entrada Plano de legendas do Adicionar legendas.

Executar e ler as Notas

Execute o workflow. Leia as Notas no nó ou no painel de configurações dele.

O Cartões UGC lê o vídeo unido e as notas dos clipes. O Sobreposição em vídeo desenha os cartões de captura de tela dele, e o Adicionar legendas desenha as legendas dele sobre o resultado.

Entradas

Entrada	Obrigatória	O que conectar
Texto	Sim	A saída Texto (ajustado) do Clipes UGC. Qualquer outra coisa faz o nó falhar, antes que qualquer tarefa de sincronização comece, com a mensagem “Conecte a saída “Texto (ajustado)” do nó “Clipes UGC”.”
Vídeo	Sim	O vídeo unido, do Combinar vídeos. Sem ele, o nó falha com a mensagem “Conecte o vídeo unido.”
Transcrição	Sim	A saída Transcrição do Clipes UGC. Sem ela, o nó falha com a mensagem “Conecte a saída “Transcrição” do nó “Clipes UGC”.”
Notas dos clipes	Não	A saída Vídeo do Clipe UGC. O Cartões UGC lê os avisos e a duração real de cada clipe. Um clipe que ficou mais longo para caber a voz desloca as janelas da verificação da fala. Sem esta entrada, as Notas não dizem nada sobre os clipes.

Saídas

Saída	O que leva
Plano de camadas	Os cartões de captura de tela, em JSON, para a entrada Plano de camadas do Sobreposição em vídeo.
Plano de legendas	As legendas, em JSON, para a entrada Plano de legendas do Adicionar legendas.
Notas	Texto simples, uma frase por linha. Em um app publicado, as Notas são uma saída de texto.

Configurações

O Cartões UGC não tem configurações. O painel de configurações mostra as Notas da última execução.

Como as palavras são sincronizadas

Os tempos das palavras vêm de um alinhamento das palavras dos clipes com o vídeo unido.

Se o alinhamento falhar ou não encontrar palavras, os cartões e as legendas são sincronizados pelo reconhecimento de fala.
Se a transcrição falhar ou não ouvir nenhuma palavra, a verificação da fala não é executada.
Se não for possível distinguir os clipes do vídeo, a verificação da fala também não é executada.
Se nada puder ser sincronizado, os dois planos ficam vazios. O Sobreposição em vídeo e o Adicionar legendas então passam o vídeo adiante sem mudanças, sem custo.

As Notas dizem qual dessas situações aconteceu.

As Notas

“Nenhum problema.” aparece só quando nada deu errado e todas as verificações foram executadas: as verificações de cada clipe e a verificação da fala. Uma verificação que não foi executada sempre recebe uma frase própria.

Quando	Frase
Nenhuma captura de tela, ou só 1 ou 2, que o roteiro descarta	Sem cartões de captura de tela: o vídeo é o criador falando. Adicione de 3 a 8 capturas de tela para ter cartões.
O alinhamento de palavras falhou ou não encontrou palavras	As legendas e os cartões foram sincronizados pelo reconhecimento de fala.
A transcrição falhou ou não ouviu nenhuma palavra	A verificação da fala não foi executada: a fala não pôde ser transcrita.
Não foi possível distinguir os clipes do vídeo, então as palavras de nenhum clipe puderam ser verificadas	A verificação da fala não foi executada: não foi possível distinguir os clipes do vídeo.
Nada pôde ser sincronizado	Sem cartões nem legendas: a fala não pôde ser sincronizada.
Um cartão cobriria a linha de encerramento	O cartão n ficou de fora: ele cobriria a linha de encerramento.
Um clipe falhou na verificação duas vezes	O clipe n ainda mostrou um problema depois de uma nova renderização (o que a verificação encontrou). Renderize-o de novo no nó Clipe UGC.
Um clipe falhou na verificação sem margem para renderizá-lo de novo	O clipe n mostrou um problema (o que a verificação encontrou) e não havia margem para renderizá-lo de novo. Renderize-o de novo no nó Clipe UGC.
A nova renderização de um clipe falhou	A nova renderização do clipe n falhou, então a primeira renderização foi mantida.
A verificação automática de um clipe não pôde ser executada, então o clipe foi mantido sem verificação	O clipe n foi mantido sem a verificação automática: desta vez, a verificação não pôde ser executada. Assista a ele e renderize-o de novo no nó Clipe UGC se algo parecer errado.
A fala de um clipe não correspondeu à linha dele	O clipe n pode não dizer a linha dele exatamente: foi ouvido “o que foi ouvido”.
Um clipe ficou mais longo para caber a voz	O clipe n foi alongado para caber a voz dele.
Nada deu errado e todas as verificações foram executadas	Nenhum problema.

Créditos

O Cartões UGC não tem preço próprio. Ele executa duas tarefas no vídeo unido, cada uma cobrada pelo próprio preço:

uma tarefa de alinhamento de palavras, pelo preço do Alinhamento forçado. Créditos: 33;
uma tarefa de transcrição, cobrada pelo próprio preço.

Quando os seus créditos não cobrem as duas tarefas, o nó para com a recusa de créditos de costume. Os cartões nunca são feitos sem as legendas deles. Primeiro, o nó verifica se as rotas UGC estão disponíveis, sem custo, então nada é pago onde elas não estão.

O editor mostra o preço da execução inteira antes de ela começar. Veja Preços no editor.

Dicas

Leia as Notas depois de cada execução. Um clipe que pode não dizer a linha dele, ou que ainda mostrou um problema, é o que deve ser renderizado de novo no Clipe UGC.
Conecte o Clipe UGC a Notas dos clipes. Sem isso, as Notas não dizem nada sobre os clipes.
Publicar não leva cartões nem Notas. Um template publicado com Incluir os resultados desta execução mostra os cartões e as Notas como exemplo.

Solução de problemas

Mensagem ou problema	Causa e solução
“Conecte a saída “Texto (ajustado)” do nó “Clipes UGC”.”	Texto está vazio, ou recebe a saída de outro nó, como o Roteiro UGC. Conecte a saída Texto (ajustado) do Clipes UGC.
“Conecte o vídeo unido.”	Conecte o vídeo unido do Combinar vídeos a Vídeo.
“Conecte a saída “Transcrição” do nó “Clipes UGC”.”	Conecte a saída Transcrição do Clipes UGC a Transcrição.
O vídeo não tem cartões.	Menos de 3 capturas de tela estão conectadas ao Roteiro UGC. Adicione de 3 a 8 capturas de tela.
O vídeo não tem cartões nem legendas.	A fala não pôde ser sincronizada. As Notas dizem isso. Confira se o vídeo unido tem a fala do criador.
As Notas não dizem nada sobre os clipes.	Conecte a saída Vídeo do Clipe UGC a Notas dos clipes.

Pela API

O Cartões UGC chama POST /v1/ugc/cards quando é executado. A primeira chamada dele é GET /v1/ugc/categories, que é gratuita e verifica se as rotas UGC estão disponíveis. Os formatos de requisição e de resposta das rotas UGC pertencem aos nós e podem mudar entre versões. Para fazer um vídeo UGC a partir de código, execute um workflow ou um app publicado que contenha os nós UGC.

No resultado de uma execução pela API, as Notas são o text do Cartões UGC. Veja Workflows e Execuções.

Assistentes de IA conectados por MCP usam ferramentas UGC próprias, como build_ugc_cards. A receita ugc-website, carregada com get_recipe, explica essas ferramentas. Veja Receitas de conteúdo.

Perguntas frequentes

O que o nó Cartões UGC faz?

O Cartões UGC descobre quando cada palavra é dita no vídeo UGC unido. A partir disso, ele define os tempos dos cartões de captura de tela para o Sobreposição em vídeo e das legendas para o Adicionar legendas. Ele também verifica a fala de cada clipe e escreve as Notas.

Quantos créditos o Cartões UGC custa?

O Cartões UGC não tem preço próprio. Ele executa uma tarefa de alinhamento de palavras e uma tarefa de transcrição no vídeo unido, cada uma cobrada pelo próprio preço.

O que são as Notas?

As Notas são frases simples sobre tudo o que não saiu como planejado, uma por linha, como um clipe que pode não dizer a linha dele exatamente. Quando nada deu errado e todas as verificações foram executadas, elas dizem “Nenhum problema.”

Por que o meu vídeo UGC não tem cartões de captura de tela?

O vídeo só tem cartões com 3 a 8 capturas de tela no Roteiro UGC. Sem nenhuma, ou com 1 ou 2, o vídeo é o criador falando, e as Notas dizem isso.

O que acontece se a fala não puder ser sincronizada?

Os dois planos ficam vazios. O Sobreposição em vídeo e o Adicionar legendas então passam o vídeo adiante sem mudanças, sem custo, e as Notas dizem que a fala não pôde ser sincronizada.

Cartões UGC

Perguntas frequentes

Páginas relacionadas

Sobreposição em vídeo

Adicionar legendas

Clipe UGC

Clipes UGC

Alinhamento forçado

Nesta página