Clipes UGC

O nó Clipes UGC divide o roteiro de um vídeo UGC em clipes, um por tomada. Ele recebe o roteiro do Roteiro UGC e o criador do Criador UGC, e verifica o roteiro de novo. Cada clipe vai para o Clipe UGC, que o renderiza.

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

Entradas

Saídas

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.

Configurações

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

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.

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

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.

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.