# Clipe UGC

> Renderize cada clipe de um vídeo UGC, verifique dois quadros, renderize de novo se a verificação falhar e refaça só os clipes de que você não gostou.

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

O nó **Clipe UGC** renderiza um clipe de um vídeo UGC: o criador dizendo as linhas desse clipe. Ele é executado uma vez para cada clipe que o [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips) fez. Quando o clipe tem voz, a voz é feita primeiro. Uma voz mais longa que o clipe deixa o clipe mais longo para caber.

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

Cada renderização é verificada. Dois dos quadros dela são lidos ao lado da imagem do criador para pegar uma tomada ruim. Se a verificação falhar, o clipe é renderizado mais uma vez e verificado de novo. A nova tomada é mantida se passar. Caso contrário, a primeira tomada é mantida, e as Notas do [**Cartões UGC**](https://nodaro.ai/docs/nodes/video/ugc-cards) dizem o que a verificação encontrou. Se a própria verificação não puder ser executada, a tomada é mantida sem ela, e as Notas dizem isso.

Em um vídeo em hebraico, cada renderização também é verificada contra a fala gravada do clipe. Uma renderização sem som falha nessa verificação e é renderizada mais uma vez. Se nenhuma renderização tiver som, o clipe para com “O clipe N não tem som, então o vídeo não pode ser finalizado. Renderize esse clipe de novo a partir do nó “Clipe UGC”.”

O nó mostra os clipes que renderizou e quantos avisos eles têm.

O Clipe 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ê tem os clipes do Clipes UGC e quer renderizá-los.
- Você quer uma nova tomada de um clipe, sem renderizar os outros de novo.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Vídeo UGC › Clipe UGC**.

### Conectar os clipes
Conecte a saída **Clipes** do Clipes UGC a **Clipe**. Mantenha essa conexão no modo **Cada item**, para que o Clipe UGC seja executado uma vez por clipe.

### Juntar os clipes
Conecte a saída **Vídeo** ao [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips) e defina essa conexão no modo **Conjunto**. Conecte o Finalização UGC ao [**Combinar vídeos**](https://nodaro.ai/docs/nodes/video/combine-videos), também no modo **Conjunto**. Conecte também **Vídeo** à entrada **Notas dos clipes** do Cartões UGC.

### Executar e revisar
Execute o workflow. Assista a cada clipe. Pressione **Renderizar de novo** em qualquer clipe de que você não gostou e execute de novo.

Workflow: O Clipe UGC renderiza cada clipe. O Finalização UGC os passa adiante em ordem, o Combinar vídeos junta os clipes por uma conexão Conjunto, o Cartões UGC define os tempos dos cartões e das legendas, e o Sobreposição em vídeo e o Adicionar legendas os desenham.

- Clipes UGC → Clipe UGC (cada item)
- Clipe UGC → Finalização UGC (conjunto)
- Finalização 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 |
| --- | --- | --- |
| **Clipe** | Sim | Um clipe da saída **Clipes** do Clipes UGC. Sem ela, o nó falha com a mensagem “Conecte a saída “Clipes” do nó “Clipes UGC”.” |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Vídeo** | O clipe pronto, um vídeo comum para qualquer entrada de vídeo. |

Uma conexão que sai do Clipe UGC fica no modo **Selecionado** por padrão, que passa adiante só um clipe. Na conexão com o [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips), ou direto com o Combinar vídeos, defina o modo **Conjunto**, para que todos os clipes sigam em ordem. Um vídeo em hebraico precisa do Finalização UGC antes da junção. Em um vídeo em inglês, o Finalização UGC passa os clipes adiante sem custo. Um vídeo de um só clipe passa pelo Combinar vídeos sem mudanças, sem custo. Veja [Modos de conexão](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes).

A mesma saída também alimenta a entrada **Notas dos clipes** do Cartões UGC, que lê os avisos e a duração real de cada clipe.

## Configurações
O Clipe UGC não tem configurações próprias. O painel de configurações lista os clipes da última execução, cada um com a duração e os avisos dele, e um botão **Renderizar de novo** para cada clipe.

### Renderizar um clipe de novo
Pressione **Renderizar de novo** em um clipe. O clipe recebe a marca “Será renderizado de novo na próxima execução”. A próxima execução do Clipe UGC, ou do workflow, renderiza esse clipe de novo e reutiliza todos os outros clipes sem custo.

No editor, um clipe cujo conteúdo não mudou não é renderizado de novo. A próxima execução devolve a tomada que ele já fez, sem custo. Um clipe é renderizado de novo quando a linha, o criador ou a voz dele mudou. Todos os clipes de um novo roteiro ou de um novo criador são renderizados de novo. A execução de um app publicado renderiza todos os clipes do próprio vídeo.

### Tudo ou nada
Se qualquer clipe falhar, o Clipe UGC falha por inteiro. Assim, uma conexão **Conjunto** depois dele nunca recebe uma lista parcial, e o vídeo unido nunca é feito com um clipe faltando. Os clipes que terminaram são mantidos e cobrados. No editor, a próxima execução os reutiliza sem custo e renderiza só o que falhou.

## Créditos
Um clipe custa:

- o preço do modelo de vídeo para a duração do clipe;
- a voz, quando o clipe tem voz;
- uma leitura de quadros para cada renderização.

Enquanto um clipe é renderizado, o nó retém cerca de duas vezes o valor previsto e devolve o que não usou.

- **Uma nova renderização** custa de novo o preço do vídeo e a leitura de quadros dele. A voz é feita uma vez.
- **Um clipe que falha** não é cobrado.
- **Um clipe nunca custa mais do que retém.** Quando a voz deixa o clipe mais longo, o clipe mais longo recebe o preço pela nova duração, a partir do mesmo valor retido. A nova renderização só acontece se o que sobrou ainda cobrir uma. As Notas dizem quando isso não foi possível.
- **Um clipe devolvido de uma execução anterior** não custa nada.

### No preço anunciado de um app ou de um template
O preço anunciado de um app ou de um template conta um vídeo UGC do jeito que as pessoas o executam. A opção de manter fica desativada no que é publicado, então o preço sempre inclui o roteiro e um criador, na duração definida para o roteiro. Uma etapa cujo preço depende da duração da entrada, como o **Combinar vídeos**, o **Cortar vídeo**, o **Vídeo em loop** ou o **Efeitos sonoros para vídeo**, pode ficar na saída do Clipe UGC. Uma etapa assim, exceto a junção do próprio vídeo, conta o Clipe UGC como um clipe na maior duração que qualquer modelo de vídeo faz.

## Preços no editor
Antes de uma execução que inclui um nó UGC, o editor calcula o preço da parte UGC da execução com o valor do próprio servidor. O valor cobre exatamente os nós que a execução processa, incluindo todas as opções de criador. O preço que ele mostra é o que a execução deve custar.

Depois, o seu saldo é comparado com o que a execução retém enquanto os clipes são renderizados, cerca de duas vezes o preço deles. A parte não usada volta quando os clipes terminam. Em um vídeo em hebraico, a fala gravada decide quantos clipes existem. A verificação então retém o maior número de clipes em que qualquer gravação aceita do vídeo pode ser dividida, não os clipes de que a duração normalmente precisa. Uma gravação tem no máximo 1,2 vez a duração alvo, e nunca mais de 21 segundos. Um saldo abaixo disso recusa a execução antes que qualquer coisa comece, e a janela de compra de créditos abre.

Essa verificação vale para todas as formas de iniciar uma execução: **Executar**, **Executar a partir daqui**, **Executar até aqui**, **Executar selecionados**, o botão de execução de um nó, **Renderização final** e **Atualizar prévia**. Uma execução sem parte UGC é verificada como de costume.

- Até o valor do servidor chegar, os botões de execução mostram a estimativa do próprio editor.
- Quando o valor não pode ser verificado, a execução pergunta antes de começar e diz por quê. **Renderização final** e **Atualizar prévia** então marcam o preço como “(estimativa)”.
- Um criador ou roteiro mantido não custa nada. Um roteiro mantido recebe o preço pela própria duração e pelos próprios cartões de captura de tela.
- Os clipes que não mudaram são reutilizados sem custo, então uma execução pode custar menos que o preço dela.

A execução de um app publicado é verificada da mesma forma antes de começar, comparando com o que o vídeo UGC dela pode reter durante a renderização.

## Dicas
- **Assista a cada clipe antes de juntá-los.** Pressione **Renderizar de novo** nos clipes de que você não gostou e execute de novo. Só esses clipes são renderizados.
- **Leia as Notas do Cartões UGC.** Uma nota como “O clipe 2 pode não dizer a linha dele exatamente” aponta o clipe a renderizar de novo.
- **Reabra o editor depois de uma execução longa.** Quando uma execução termina com o editor fechado, reabrir o editor mostra os resultados dessa execução nos nós UGC e na junção, na sobreposição e nas legendas do próprio vídeo. A execução mais recente prevalece. O Clipe UGC e esses três nós mostram o vídeo mais recente primeiro e mantêm os mais antigos abaixo dele.
- **Publicar não leva nenhuma tomada.** Um template publicado com **Incluir os resultados desta execução** mostra a tomada atual de cada clipe como exemplo.

## Solução de problemas
| Mensagem ou problema | Causa e solução |
| --- | --- |
| “Conecte a saída “Clipes” do nó “Clipes UGC”.” | Nada está conectado a **Clipe**. Conecte a saída **Clipes** do Clipes UGC. |
| O Combinar vídeos recebe só um clipe. | A conexão que sai do Clipe UGC está no modo **Selecionado**. Defina-a no modo **Conjunto**. |
| A execução é recusada antes de começar, e a janela de compra de créditos abre. | O seu saldo está abaixo do que a execução retém enquanto os clipes são renderizados, cerca de duas vezes o preço deles. Adicione créditos ou faça um vídeo mais curto. |
| “O clipe N não tem som, então o vídeo não pode ser finalizado. Renderize esse clipe de novo a partir do nó “Clipe UGC”.” | Em um vídeo em hebraico, nenhuma renderização desse clipe teve som. Pressione **Renderizar de novo** no clipe e execute de novo. |
| Um clipe parece errado. | Pressione **Renderizar de novo** nesse clipe e execute de novo. |
| O Clipe UGC falhou, mas alguns clipes terminaram. | Um clipe falhou, então o nó falhou por inteiro. Execute de novo: no editor, os clipes prontos são reutilizados sem custo. |

## Pela API
O Clipe UGC chama `POST /v1/ugc/clip` quando é executado, e a rota responde com o id de uma tarefa. 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. Veja [Workflows](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values).

A execução de um vídeo UGC por um app publicado é verificada antes de começar. Quando quem paga não consegue cobrir o que o vídeo pode reter enquanto os clipes são renderizados, a execução é recusada com `402 insufficient_credits`, antes que qualquer coisa seja executada ou cobrada. A mensagem é “Este vídeo pode reter até cerca de … créditos durante a renderização; o seu saldo é ….” Veja [MiniApps](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code) e [Créditos](https://nodaro.ai/docs/developers/api/credits).

## Perguntas frequentes

### O que o nó Clipe UGC faz?

O Clipe UGC renderiza um clipe de um vídeo UGC: o criador dizendo as linhas desse clipe. Ele é executado uma vez para cada clipe que o Clipes UGC fez e verifica dois quadros de cada renderização.

### Como junto os clipes em um só vídeo?

Defina a conexão que sai da saída Vídeo do Clipe UGC no modo Conjunto e conecte-a ao Combinar vídeos. O Combinar vídeos junta os clipes em ordem.

### Posso renderizar de novo só um clipe?

Sim. No painel de configurações, pressione Renderizar de novo no clipe de que você não gostou e execute de novo. Só esse clipe é renderizado, e todos os outros clipes são reutilizados sem custo.

### Quantos créditos um clipe UGC custa?

Um clipe custa o preço do modelo de vídeo para a duração do clipe, mais a voz, mais uma leitura de quadros para cada renderização. O editor mostra o preço da execução antes de ela começar.

### Por que uma execução UGC retém mais créditos do que o preço dela?

Enquanto os clipes são renderizados, a execução retém cerca de duas vezes o preço previsto deles. A parte não usada volta quando eles terminam.

### O que acontece quando um clipe falha?

O Clipe UGC falha por inteiro, então o vídeo unido nunca é feito com um clipe faltando. Os clipes que terminaram são mantidos e cobrados, e a próxima execução no editor os reutiliza sem custo.