# Cartões UGC

> 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.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/ugc-cards

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**](https://nodaro.ai/docs/nodes/video/ugc-clip), unidos pelo [**Combinar vídeos**](https://nodaro.ai/docs/nodes/video/combine-videos). Ele também verifica se cada clipe disse a linha dele e escreve as **Notas**.

- Found in: Video › UGC Video
- API type: `ugc-cards`

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**](https://nodaro.ai/docs/nodes/video/video-overlay#layer-plan-input).
- **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**](https://nodaro.ai/docs/nodes/video/add-captions#caption-plan-input). 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.

Workflow: 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.

- Clipes UGC → Cartões UGC (texto (ajustado))
- Clipe UGC → Combinar vídeos (conjunto)
- Clipe UGC → Cartões UGC (notas dos clipes)
- Combinar vídeos → Cartões UGC (vídeo)
- Cartões UGC → Sobreposição em vídeo (plano de camadas)
- Sobreposição em vídeo → Adicionar legendas (vídeo)

## 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**](https://nodaro.ai/docs/nodes/audio/forced-alignment). 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](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-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](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values) e [Execuções](https://nodaro.ai/docs/developers/api/executions).

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](https://nodaro.ai/docs/mcp/recipes).

## 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.