# Clipes UGC

> Divida o roteiro de um vídeo UGC em clipes, um por tomada, escolha a voz do criador e veja quanto os clipes e as etapas seguintes vão custar.

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

O nó **Clipes UGC** divide o roteiro de um vídeo UGC em clipes, um por tomada. Ele recebe o roteiro do [**Roteiro UGC**](https://nodaro.ai/docs/nodes/video/ugc-script) e o criador do [**Criador UGC**](https://nodaro.ai/docs/nodes/video/ugc-creator), e verifica o roteiro de novo. Cada clipe vai para o [**Clipe UGC**](https://nodaro.ai/docs/nodes/video/ugc-clip), que o renderiza.

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

Quantos clipes um vídeo tem depende da duração e das linhas dele. O nó mostra os clipes e a duração de cada um. Executado sozinho, ele também mostra quanto os clipes e as etapas seguintes vão custar.

O Clipes 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 um roteiro do Roteiro UGC e um criador do Criador UGC e quer renderizar o vídeo.
- Você quer ver quanto os clipes vão custar antes que qualquer clipe seja renderizado.
- Você quer escolher a voz com que o criador fala.

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

### Conectar o roteiro e o criador
Conecte a saída **Texto** do Roteiro UGC a **Texto**. Conecte a saída **Criador** do Criador UGC a **Criador**.

### Conectar as saídas
Conecte **Clipes** à entrada **Clipe** do Clipe UGC. Conecte **Texto (ajustado)** e **Transcrição** às entradas correspondentes do [**Cartões UGC**](https://nodaro.ai/docs/nodes/video/ugc-cards). Conecte **Texto (ajustado)** também à entrada **Texto** do [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips).

### Executar
Pressione o botão de execução do próprio nó para ver os clipes e quanto eles vão custar. Ou execute o workflow inteiro, que segue adiante e renderiza os clipes.

Workflow: O Clipes UGC divide o roteiro em clipes. O Clipe UGC é executado uma vez por clipe, e o Cartões UGC recebe o roteiro com os clipes marcados.

- Roteiro UGC → Clipes UGC (texto)
- Criador UGC → Clipes UGC (criador)
- Clipes UGC → Clipe UGC (clipe)
- Clipes UGC → Cartões UGC (texto (ajustado))

## Entradas
| Entrada | Obrigatória | O que conectar |
| --- | --- | --- |
| **Texto** | Sim | A saída **Texto** do Roteiro UGC. Sem ela, o nó falha com a mensagem “Conecte a saída “Texto” do nó “Roteiro UGC”.” |
| **Criador** | Sim | A saída **Criador** do Criador UGC. Enquanto o Criador UGC não tem um criador, o nó falha com a mensagem “O nó “Criador UGC” ainda não tem um criador. Execute-o ou escolha uma das opções dele.” Isso acontece quando o Criador UGC não foi executado, ou quando as opções dele esperam a sua escolha. |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Clipes** | Os clipes, um por tomada. Uma conexão que sai de **Clipes** fica no modo **Cada item** por padrão, então o Clipe UGC é executado uma vez por clipe. Um vídeo de um só clipe entrega esse clipe ao Clipe UGC. |
| **Texto (ajustado)** | O roteiro com os clipes marcados, em JSON, para a entrada **Texto** do Cartões UGC e do [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips). Um único valor. |
| **Transcrição** | Texto simples: todas as palavras que os clipes dizem, em ordem, para a entrada **Transcrição** do Cartões UGC. Um único valor. |

Só **Clipes** se ramifica. As outras duas saídas passam um único valor, qualquer que seja o modo das conexões delas. Veja [Modos de conexão](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes).

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Voz** | A voz com que o criador fala. **Voz padrão** escolhe uma voz que combina com o criador. Você também pode escolher qualquer voz no navegador de vozes. |

### O roteiro é verificado de novo
O Clipes UGC verifica o roteiro pelas regras do vídeo de novo. Um roteiro só pode quebrar uma regra depois que você edita as linhas dele no Roteiro UGC. Um roteiro assim faz o Clipes UGC falhar antes que qualquer clipe seja pago, com a mensagem “O roteiro precisa de alterações:”, seguida de cada problema e da correção dele.

### Um roteiro em hebraico
Um roteiro em hebraico é primeiro gravado como uma única fala, com a voz escolhida. As palavras dele recebem tempos, e a fala é dividida nas pausas. O Clipes UGC então passa adiante um clipe por trecho, cada um com até 7 segundos. Essas três etapas são cobradas pelos próprios preços.

A gravação pode ter no máximo 1,2 vez a duração do vídeo, e nunca mais de 21 segundos. Uma gravação mais longa interrompe a execução na divisão, com “SPEECH_TOO_LONG … Encurte o roteiro.” A cobrança da divisão é reembolsada. A fala e os tempos das palavras dela continuam cobrados. O [**Roteiro UGC**](https://nodaro.ai/docs/nodes/video/ugc-script) já reescreve um roteiro em hebraico longo demais para a duração do vídeo, contado a 2,5 palavras por segundo: 45 palavras para um vídeo de 15 segundos, e no máximo 52 palavras.

As vozes em hebraico são Maya e Shira (mulher), e Itai e Omer (homem).

Antes que qualquer clipe de um vídeo em hebraico seja renderizado, o Clipes UGC calcula o preço dos clipes que a divisão passou adiante, com as etapas seguintes. Cada clipe é precificado pelo que ele retém enquanto é renderizado. O Clipes UGC compara esse preço com o valor pelo qual o seu saldo foi verificado antes de a execução começar: o maior número de clipes em que qualquer gravação aceita do vídeo pode ser dividida. Quando os clipes reteriam mais, a execução para aqui, antes que qualquer clipe seja renderizado. A fala, os tempos das palavras dela e a divisão dela continuam cobrados. O nó falha com a mensagem “Os clipes desta gravação custariam mais do que o valor verificado para esta execução, então nenhum foi renderizado. Execute “Clipes UGC” de novo para gravar a fala outra vez.” A verificação em si é gratuita.

Um vídeo em hebraico precisa do [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips) depois do Clipe UGC, com a saída **Texto (ajustado)** do Clipes UGC conectada a ele. Sem ele, o Clipes UGC falha antes de gastar qualquer coisa, com a mensagem “Adicione um nó “Finalização UGC” depois de “Clipe UGC” e conecte a ele a saída “Texto (ajustado)” de “Clipes UGC”.”

### Quanto os clipes vão custar
Quando você executa o Clipes UGC com o próprio botão de execução, o nó mostra quanto os clipes dele vão custar:

- **Linhas de clipe:** uma linha para cada clipe, com a duração dele.
- **Linhas de etapa:** uma linha para cada etapa depois dos clipes. As etapas são a finalização dos clipes em um vídeo em hebraico, a junção dos clipes, quando há vários, os tempos das palavras, a verificação da fala, os cartões de captura de tela, quando há algum, e as legendas.
- **Previsto:** quanto o vídeo deve custar.
- **Retido durante a renderização dos clipes:** o que a execução retém enquanto os clipes são renderizados, cerca de duas vezes o preço dos clipes.

Execute os nós UGC um de cada vez dessa forma para ver o valor antes que qualquer clipe seja renderizado. Uma execução do workflow inteiro segue direto para os clipes, e o Clipes UGC não mostra nenhum valor. O preço de uma execução assim aparece antes de ela começar: veja [Preços no editor](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor).

## Créditos
O Clipes UGC é gratuito. Os valores que ele mostra são o que o Clipe UGC e as etapas seguintes vão custar. Veja [Créditos do Clipe UGC](https://nodaro.ai/docs/nodes/video/ugc-clip#credits).

## Dicas
- **Veja o preço primeiro.** Execute o Roteiro UGC, o Criador UGC e o Clipes UGC um de cada vez, cada um com o próprio botão de execução, para ver quanto os clipes vão custar antes de renderizá-los.
- **Confira a duração dos clipes antes de renderizar.** Um vídeo mais longo gera mais clipes.
- **Mantenha os modos de conexão padrão.** **Clipes** fica no modo **Cada item** para que o Clipe UGC seja executado uma vez por clipe.

## Solução de problemas
| Mensagem ou problema | Causa e solução |
| --- | --- |
| “Conecte a saída “Texto” do nó “Roteiro UGC”.” | Nada está conectado a **Texto**. Conecte a saída **Texto** do Roteiro UGC. |
| “O nó “Criador UGC” ainda não tem um criador. Execute-o ou escolha uma das opções dele.” | Execute o Criador UGC ou pressione **Usar esta** em uma das opções dele. |
| “O roteiro precisa de alterações:” | Uma linha editada quebra uma regra do vídeo. Corrija no Roteiro UGC cada problema que a mensagem cita, ou execute o Roteiro UGC de novo. |
| “Adicione um nó “Finalização UGC” depois de “Clipe UGC” e conecte a ele a saída “Texto (ajustado)” de “Clipes UGC”.” | O roteiro está em hebraico, e nenhum Finalização UGC recebe a saída **Texto (ajustado)**. Adicione o [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips) depois do Clipe UGC e conecte-o. Nada foi gasto. |
| “SPEECH_TOO_LONG … Encurte o roteiro.” | A gravação em hebraico é mais longa que 1,2 vez a duração do vídeo, ou mais longa que 21 segundos. Encurte o roteiro no Roteiro UGC, ou execute o Roteiro UGC de novo. A cobrança da divisão é reembolsada. |
| “Os clipes desta gravação custariam mais do que o valor verificado para esta execução, então nenhum foi renderizado. Execute “Clipes UGC” de novo para gravar a fala outra vez.” | A gravação em hebraico foi dividida em clipes que reteriam mais do que o valor verificado para a execução. Execute o Clipes UGC de novo para gravar a fala outra vez. Nenhum clipe foi renderizado. |
| O Clipe UGC renderiza só um clipe. | A conexão que sai de **Clipes** não está no modo **Cada item**. Volte-a para **Cada item**. |

## Pela API
O Clipes UGC chama `POST /v1/ugc/clips` quando é executado. 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).

`POST /v1/ugc/quote` calcula o preço de um vídeo UGC. Ela é gratuita, nada é reservado, e ela aceita 30 chamadas por minuto. Ela tem duas formas:

- **Tickets:** `{ "tickets": [ … ], "hasCards": true }` calcula o preço dos 1 a 11 clipes que o Clipes UGC repassou, como o Clipe UGC e as etapas seguintes vão custar. Esse é o valor que o Clipes UGC mostra.
- **Estimativa:** `{ "estimate": { "targetDurationSec": 15, "screenshotCount": 3, "source": "sampled" } }` calcula o preço de um vídeo inteiro antes que qualquer coisa seja executada, incluindo o roteiro e o criador. `targetDurationSec` vai de 4 a 300. `screenshotCount` vai de 0 a 8, e 1 ou 2 contam como nenhuma. `source` é `sampled` (um criador de IA) ou `photo`. O opcional `rendersEveryCandidate` calcula o preço de todas as opções de criador, como uma execução no editor as gera.

A forma de tickets aceita dois campos opcionais:

- `finishes: true` diz que os clipes passam pela tarefa do Finalização UGC, como em um vídeo em hebraico. A resposta então tem uma linha “Finalizar os clipes” (chave `finish`), cobrada uma única vez. A linha de junção (chave `join`) é precificada como o nó de junção do template é cobrado, com as configurações dele. Cada clipe conta com a duração padrão de 8 segundos do **Combinar vídeos**, porque os clipes chegam a ele como uma única lista sem a duração dos clipes.
- `runEstimate` é a entrada da estimativa do vídeo a que os clipes pertencem (`targetDurationSec`, `screenshotCount`, `source` e `language`). A resposta então também tem `runHold`: o máximo que a estimativa do vídeo retém para os clipes dele e as etapas seguintes, precificado com os mesmos `hasCards` e `finishes`.

As duas formas respondem `lines` (cada uma com um `label` em inglês, os `credits` dela e uma `key` estável), `expected`, `ceiling` (o que o vídeo retém enquanto os clipes são renderizados), `parts` e `holdParts`. A estimativa também responde `range`, o preço previsto com 0,8× e 1,2× a duração, e `worstCase`. Um item cujo preço não pode ser calculado responde `422 unpriceable`. Onde as rotas UGC não estão disponíveis, a rota responde `503 not_available`.

Para um vídeo em hebraico (`language: "he"` na estimativa), a fala gravada decide quantos clipes existem, então a estimativa não tem as execuções com 0,8× e 1,2×. `expected` e `ceiling` são os clipes de que a fala deve precisar, e `range` vai até o maior número de clipes de que uma fala assim normalmente precisa. `worstCase` retém a forma mais cara como qualquer gravação aceita pode ser dividida, cada clipe com o dobro do preço dele. Uma gravação tem no máximo 1,2 vez a duração alvo e nunca mais de 21 segundos: 18 segundos para um vídeo de 15 segundos, e 21 segundos a partir de um vídeo de 17,5 segundos. Por isso, o pior caso cresce com a duração alvo, até seis clipes de até 7 segundos. A fala, os tempos das palavras dela, a divisão dela e a finalização são linhas próprias, cada uma cobrada uma única vez.

Antes que os clipes de um vídeo em hebraico sejam renderizados, o Clipes UGC pede à forma de tickets, com `runEstimate`, o preço dos clipes que a divisão passou adiante. Isso acontece no editor, em um app publicado e em uma execução pela API da mesma forma. Quando o `ceiling` deles passa de `runHold`, ou quando nenhum valor pode ser obtido, a execução para no Clipes UGC antes que qualquer clipe seja renderizado.

## Perguntas frequentes

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

O Clipes UGC recebe o roteiro do Roteiro UGC e o criador do Criador UGC, verifica o roteiro de novo e o divide em clipes, um por tomada. Depois, o Clipe UGC renderiza cada clipe.

### O Clipes UGC custa créditos?

Não. O Clipes UGC é gratuito. Os valores que ele mostra são o que o Clipe UGC e as etapas seguintes vão custar.

### Como vejo quanto um vídeo UGC custa antes de renderizar?

Execute o Roteiro UGC, o Criador UGC e o Clipes UGC um de cada vez, cada um com o próprio botão de execução. O Clipes UGC mostra então uma linha para cada clipe e para cada etapa seguinte, o valor Previsto e o que fica Retido durante a renderização dos clipes.

### Quantos clipes um vídeo UGC tem?

Depende da duração do vídeo e das linhas dele. O Clipes UGC mostra os clipes e a duração de cada um. Um vídeo mais longo gera mais clipes.

### Qual pode ser a duração de uma gravação UGC em hebraico?

Um roteiro em hebraico é gravado como uma única fala. A gravação pode ter no máximo 1,2 vez a duração do vídeo, e nunca mais de 21 segundos. Uma gravação mais longa interrompe a execução com “SPEECH_TOO_LONG”, e a cobrança da divisão é reembolsada.

### Com qual voz o criador fala?

Voz padrão escolhe uma voz que combina com o criador. Você também pode escolher qualquer voz no navegador de vozes do painel de configurações.