Roteiro UGC

O nó Roteiro UGC escreve o que o criador diz em um vídeo UGC: a linha de abertura, os trechos e a linha de encerramento. Ele lê até 8 capturas de tela e o nome ou o site do produto que você informa. Ele verifica o roteiro pelas regras do vídeo e o reescreve quando o roteiro quebra uma delas.

O Roteiro UGC também escolhe a categoria de produto para a qual o Criador UGC gera o criador. O próximo nó costuma ser o Clipes UGC, que divide o roteiro em clipes.

O Roteiro 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ê quer um vídeo curto de um criador que fala sobre o seu produto ou o seu site.
• Você tem capturas de tela do seu site ou app e quer que cada uma apareça como um cartão enquanto o criador fala dela.
• Você quer um roteiro que já caiba na duração do vídeo.

Para um roteiro com várias cenas, com prompts de imagem, diálogos e climas musicais, use o Gerar roteiro.

Início rápido

Entradas

Quantas capturas de tela

• De 3 a 8 capturas de tela: um trecho para cada uma, na ordem das entradas, começando pela Captura de tela 1. Cada captura de tela aparece como um cartão enquanto o criador fala dela. O Cartões UGC define os tempos dos cartões.
• 1 ou 2 capturas de tela são descartadas. O vídeo é o criador falando, sem cartões, e as Notas do Cartões UGC dizem isso.
• Nenhuma captura de tela: o mesmo vídeo do criador falando.

O Roteiro UGC lê as capturas de tela como imagens. Ele nunca visita o site.

Saídas

Configurações

As configurações também dizem em quantas rodadas o roteiro foi escrito, por exemplo “Escrito em 2 rodadas”.

Como o roteiro é verificado

O Roteiro UGC verifica o roteiro pelas regras do vídeo. Quando o roteiro quebra uma regra, o nó o reescreve a partir do que a verificação encontrou. Ele tenta três vezes ao todo: a primeira escrita e até duas reescritas.

Editar as linhas

Depois de uma execução, as configurações mostram as linhas do roteiro: Linha de abertura, cada trecho (Trecho 1, Trecho 2 e assim por diante) e Linha de encerramento.

1. Pressione Editar e mude as palavras das linhas.
2. Pressione Salvar para gravá-las no roteiro. Salvar ativa Manter este roteiro, então a próxima execução usa as suas linhas.
3. Pressione Cancelar para deixar o roteiro como estava.

Só as palavras das linhas podem ser editadas. Uma linha em branco é recusada, por exemplo com a mensagem “A linha do trecho 2 está vazia.”

Uma linha acima do limite de caracteres do roteiro também é recusada, por exemplo com a mensagem “A linha do trecho 2 está longa demais — use no máximo … caracteres.”

O Clipes UGC verifica de novo um roteiro editado antes que qualquer clipe seja pago. Um roteiro que quebra uma regra faz o Clipes UGC falhar com a mensagem “O roteiro precisa de alterações:”, seguida de cada problema e da correção dele.

Em um app publicado

A duração pode ser uma entrada do app, Duração do vídeo (segundos). Ela é um controle deslizante de 4 a 300 segundos, ou uma escolha entre as durações que o app permite. Publicado como app, o tutorial Vídeo UGC a partir do seu site oferece 15, 20 e 25 segundos.

Créditos

O Roteiro UGC cobra um preço fixo por execução, não importa quantas reescritas ele faça. O editor mostra o preço no botão Executar antes de a execução começar.

• Uma execução que não consegue cumprir as regras depois de três tentativas é reembolsada. Ela falha com a mensagem “O roteiro não conseguiu cumprir as regras do vídeo depois de três tentativas:”, seguida do que ainda estava errado.
• Uma execução que falha por qualquer outro motivo também é reembolsada.
• Um roteiro mantido é repassado sem custo. Os clipes depois dele recebem o preço pela duração e pelos cartões de captura de tela do próprio roteiro mantido.

Veja Preços no editor para o preço do vídeo inteiro.

Dicas

• Envie as capturas de tela na ordem da fala. A ordem dos cartões é a ordem das entradas de captura de tela.
• Mantenha um roteiro de que você gostou. Ative Manter este roteiro, ou edite as linhas e salve. A próxima execução do workflow inteiro repassa então o roteiro em vez de pagar por um novo.
• Use de 3 a 8 capturas de tela para ter cartões. Com menos, o vídeo fica sem cartões.
• Publicar leva o roteiro vazio. Um template publicado com Incluir os resultados desta execução mostra as linhas faladas como exemplo, até que a pessoa que o copia escreva um primeiro roteiro.

Solução de problemas

Pela API

O Roteiro UGC chama POST /v1/ugc/script 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.

Uma requisição de execução pode definir o targetDurationSec do Roteiro UGC, de 4 a 300. Em um nó UGC, uma execução também pode definir só source, gender e photoUrl do Criador UGC. Qualquer outro campo em um nó UGC responde 400 locked_field. Veja Workflows e MiniApps.

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