# Criador UGC

> Escolha quem fala para a câmera em um vídeo UGC: um criador de IA feito para o seu produto ou a sua foto. Mantenha o criador de que gostou.

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

O nó **Criador UGC** decide quem fala para a câmera em um vídeo UGC: um **criador de IA** feito para o seu produto ou a **sua própria foto**. O criador segue para o [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips), e todos os clipes do vídeo mostram essa pessoa.

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

O Criador UGC é um dos seis nós de vídeo UGC. Com o [**Roteiro UGC**](https://nodaro.ai/docs/nodes/video/ugc-script), o [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips), o [**Clipe UGC**](https://nodaro.ai/docs/nodes/video/ugc-clip), o [**Finalização UGC**](https://nodaro.ai/docs/nodes/video/ugc-finish-clips) e o [**Cartões UGC**](https://nodaro.ai/docs/nodes/video/ugc-cards), ele faz um vídeo de um criador que fala sobre o seu produto. Enquanto isso, as suas capturas de tela aparecem como cartões, com legendas.

O Criador 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.”

Os criadores são só adultos, e uma foto precisa mostrar exatamente um adulto, com o rosto bem visível. Um seletor **Pessoa** conectado a **Visual do criador** que define uma idade abaixo de 20 anos é recusado. O mesmo vale para um tipo que indica um menor de idade quando nenhuma idade adulta está definida. A mensagem é “Essa idade não pode ser usada: criadores UGC precisam ser adultos.”

## Quando usar
- Você faz um vídeo UGC e quer um criador de IA que combine com o seu produto.
- Você quer apresentar o vídeo você mesmo, a partir de uma foto.
- Você encontrou um criador de que gostou e quer a mesma pessoa em todos os próximos vídeos.

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

### Escolher o criador
Abra o painel de configurações. Mantenha **Criador de IA**, ou escolha **Minha foto** e conecte um nó [**Enviar imagem**](https://nodaro.ai/docs/nodes/image/upload-image) a **Sua foto**. Escolha **Mulher** ou **Homem** em **Gênero**.

### Conectar a categoria e o visual
Conecte a saída **Categoria** do [**Roteiro UGC**](https://nodaro.ai/docs/nodes/video/ugc-script) a **Categoria do produto**. Para orientar um criador de IA, conecte seletores **Pessoa**, **Figurino e beleza**, **Cenário** ou **Iluminação** a **Visual do criador**.

### Executar e escolher um criador
Clique em **Executar**. As opções aparecem no nó, lado a lado. Pressione **Usar esta** no criador que você quer. Depois pressione **Executar a partir daqui** no Criador UGC para fazer o vídeo.

Workflow: O Roteiro UGC escreve o roteiro, o Criador UGC escolhe a pessoa, o Clipes UGC divide o roteiro, o Clipe UGC renderiza cada clipe, o Combinar vídeos junta os clipes e o Cartões UGC sincroniza os cartões para o Sobreposição em vídeo e as legendas para o Adicionar legendas.

- Roteiro UGC → Criador UGC (categoria)
- Roteiro UGC → Clipes UGC (texto)
- Criador UGC → Clipes UGC (criador)
- Clipes UGC → Clipe UGC (clipe)
- Clipe UGC → Combinar vídeos (conjunto)
- 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 |
| --- | --- | --- |
| **Sua foto** | Só para **Minha foto** | Uma imagem sua, por exemplo do Enviar imagem. Uma foto conectada tem prioridade sobre uma foto definida nas configurações. |
| **Categoria do produto** | Não | A saída **Categoria** do [**Roteiro UGC**](https://nodaro.ai/docs/nodes/video/ugc-script). Uma categoria escolhida no nó tem prioridade. |
| **Visual do criador** | Não | Seletores [**Pessoa**](https://nodaro.ai/docs/nodes/creative-controls/person), [**Figurino e beleza**](https://nodaro.ai/docs/nodes/creative-controls/styling), [**Cenário**](https://nodaro.ai/docs/nodes/creative-controls/setting) e [**Iluminação**](https://nodaro.ai/docs/nodes/creative-controls/lighting). Vários seletores podem compartilhar esta entrada. Só os campos que você define neles são usados, e o nó lista os seletores conectados. |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Criador** | O criador, em JSON, para a entrada **Criador** do [**Clipes UGC**](https://nodaro.ai/docs/nodes/video/ugc-clips). |
| **Imagem** | A imagem do criador, para qualquer entrada de imagem. |

Nada sai do nó enquanto as opções dele esperam a sua escolha.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Criador** | **Criador de IA**, o padrão, ou **Minha foto**. |
| **Gênero** | **Mulher**, o padrão, ou **Homem**. Um criador de IA é gerado com esse gênero, e cada imagem é verificada quanto a isso. |
| **Categoria do produto** | Só para criador de IA. **Do roteiro**, o padrão, usa a categoria que o Roteiro UGC escolheu. Você também pode escolher uma categoria da lista, como **Cuidados com a pele**, **Tecnologia** ou **Comida**. |
| **Seed** | Só para criador de IA, opcional. Fixa a escolha aleatória do visual do criador. |
| **Manter este criador** | Desativado por padrão. Quando está ativado, a próxima execução repassa o último criador sem gerar de novo, sem custo. |
| **Sua foto** | Só para **Minha foto**. A foto usada quando nada está conectado a **Sua foto**. O cartão de criador de um app publicado a define. As configurações a mostram, com **Remover imagem**. |

No editor, dê a foto para **Minha foto** pela entrada **Sua foto**. Sem uma foto, o nó falha com a mensagem “Conecte ou envie uma foto sua.” Envie só uma foto sua ou de alguém que concordou com isso.

### Como um criador de IA é gerado
Um criador de IA é gerado para a categoria do produto, para o gênero que você escolhe e para os campos que os seletores de **Visual do criador** definem. Cada nova geração é uma pessoa diferente. O novo criador difere do último que você viu em pelo menos dois destes pontos: idade, cor do cabelo, penteado e porte físico, a menos que os seus seletores os fixem.

- **No editor**, o nó gera algumas opções, e a execução para no Criador UGC até você escolher uma.
- **Em um app publicado ou em uma execução pela API**, o nó gera um criador, e a execução continua.
- **Em um sub-workflow, ou uma vez por item de uma lista**, o nó também gera um criador, e a execução continua.

Quando sai só uma opção, o nó usa essa opção sem perguntar.

### Escolher um criador
As opções esperam no nó, lado a lado, com os rótulos **Opção 1**, **Opção 2** e assim por diante.

- **Usar esta** mantém a opção e ativa **Manter este criador**. Depois pressione **Executar a partir daqui** no Criador UGC para fazer o vídeo.
- **Mostrar novas opções** gera de novo. As novas opções são diferentes das que você viu. Sobre um criador mantido, **Mostrar novas opções** desativa **Manter este criador** e executa o nó.

Enquanto há opções esperando, uma execução que inclui o Criador UGC é recusada com a mensagem “Escolha um criador primeiro.” Se uma opção não puder ser feita, as outras ainda são mostradas, com um aviso.

## Créditos
O Criador UGC não tem preço próprio. O que uma execução cobra:

- **Cada imagem que ele gera** é uma tarefa de imagem normal, cobrada pelo preço do modelo de imagem.
- **Cada imagem é verificada** com uma leitura de imagem, para confirmar que a pessoa corresponde ao gênero que você escolheu.
- **No editor**, todas as opções são geradas e verificadas. **Em um app publicado ou em uma execução pela API**, um criador é gerado e verificado.
- **Uma foto** é verificada com uma leitura de imagem. Uma foto reprovada é recusada com a mensagem “Esta foto não pode ser usada: ela precisa mostrar exatamente um adulto, com o rosto bem visível.”
- **Um criador mantido** é repassado sem custo.

Se a moderação bloquear todas as imagens de uma geração, mais uma imagem é gerada no lugar delas, pelo próprio preço, e verificada da mesma forma.

Se nenhuma opção passar na verificação, o criador é gerado mais uma vez, pelo mesmo preço de novo. Se essa geração também falhar, a execução para antes que qualquer clipe seja renderizado. A mensagem é “O criador de IA não saiu como a pessoa que você escolheu. Execute o Criador UGC de novo.” O roteiro que o Roteiro UGC já escreveu continua sendo cobrado.

Se os seus créditos acabarem durante uma geração, o nó para. No editor, a janela de compra de créditos abre, e as opções já verificadas ficam no nó para você escolher.

Antes de uma execução, o editor mostra o preço do criador junto com o resto do vídeo. Veja [Preços no editor](https://nodaro.ai/docs/nodes/video/ugc-clip#prices-in-the-editor).

## Dicas
- **Oriente o visual com seletores.** Use **Pessoa** para idade, cabelo e porte físico, **Figurino e beleza** para maquiagem, cabelo e roupa, **Cenário** para o lugar onde o criador grava e **Iluminação** para a luz.
- **Deixe Visual do criador vazio** para um criador gerado só a partir da categoria do produto.
- **Mantenha um criador de que você gostou.** Pressione **Usar esta**, e todas as próximas execuções usam a mesma pessoa, sem custo.
- **A sua foto continua privada.** Um app ou template publicado nunca leva a sua foto. Um app definido como **Minha foto** pede a cada pessoa que o executa uma foto dela.

## Solução de problemas
| Mensagem ou problema | Causa e solução |
| --- | --- |
| “Escolha um criador primeiro.” | Há opções esperando no nó. Pressione **Usar esta** em uma delas, ou **Mostrar novas opções**. |
| “Conecte ou envie uma foto sua.” | **Minha foto** está definido, mas nenhuma foto está conectada a **Sua foto**. Conecte um nó Enviar imagem. |
| “Esta foto não pode ser usada: ela precisa mostrar exatamente um adulto, com o rosto bem visível.” | Use uma foto de um adulto, de frente para a câmera, com o rosto bem visível. |
| “Execute o nó “Roteiro UGC” primeiro ou escolha uma categoria de produto.” | Um criador de IA precisa de uma categoria de produto. Conecte a saída **Categoria** do Roteiro UGC, ou escolha uma categoria no nó. |
| “Essa idade não pode ser usada: criadores UGC precisam ser adultos.” | Um seletor Pessoa define uma idade abaixo de 20 anos, ou um tipo que indica um menor de idade. Defina uma idade adulta. |
| “O criador de IA não saiu como a pessoa que você escolheu. Execute o Criador UGC de novo.” | Nenhuma imagem gerada correspondeu ao gênero que você escolheu, duas vezes. Execute o Criador UGC de novo. |
| “Os vídeos UGC são um recurso do Nodaro Cloud e não estão disponíveis nesta instância.” | Os nós UGC são executados só no Nodaro Cloud. Use o workflow em app.nodaro.ai. |

## Pela API
O Criador UGC chama `POST /v1/ugc/creator` 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. Uma execução pela API gera um criador e nunca espera uma escolha.

Uma requisição de execução pode definir só três campos do Criador UGC: `source` (`sampled` para um criador de IA, `photo` para Minha foto), `gender` (`woman` ou `man`) e `photoUrl`. Qualquer outro campo em um nó UGC responde `400 locked_field`. Veja [Workflows](https://nodaro.ai/docs/developers/api/workflows#run-a-workflow-with-new-input-values) e [MiniApps](https://nodaro.ai/docs/concepts/apps#embed-a-miniapp-or-run-it-from-code).

Assistentes de IA conectados por MCP usam ferramentas UGC próprias, como `build_ugc_creator`. 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ó Criador UGC faz?

O Criador UGC decide quem fala para a câmera em um vídeo UGC. Ele cria um criador de IA para o seu produto ou usa a sua própria foto. Todos os clipes do vídeo mostram essa pessoa.

### Por que a minha execução para no Criador UGC?

No editor, um criador de IA é gerado como algumas opções lado a lado, e a execução espera a sua escolha. Pressione Usar esta em uma opção e depois Executar a partir daqui no Criador UGC para fazer o vídeo.

### Posso usar o meu próprio rosto em um vídeo UGC?

Sim. Defina Criador como Minha foto e conecte um nó Enviar imagem à entrada Sua foto. A foto precisa mostrar exatamente um adulto, com o rosto bem visível.

### Quantos créditos o Criador UGC custa?

O nó não tem preço próprio. Cada imagem que ele gera é cobrada pelo preço do modelo de imagem, e cada imagem passa por uma leitura de imagem para ser verificada. Um criador mantido não custa nada.

### Um criador UGC pode ser uma criança?

Não. Os criadores UGC são só adultos. Um seletor Pessoa que define uma idade abaixo de 20 anos, ou um tipo que indica um menor de idade, é recusado.