# Receitas de conteúdo

> Receitas de conteúdo são guias testados, carregados com get_recipe, que levam um assistente de IA por todo um fluxo do Nodaro, como um explicativo animado.

Source: https://nodaro.ai/pt-BR/docs/mcp/recipes

Uma **receita de conteúdo** é um guia testado que conduz um assistente de IA por um fluxo completo do Nodaro até um resultado. A receita `video-explainer`, por exemplo, faz o assistente fixar um estilo visual, escrever a narração, renderizar clipes sem som, dar voz a eles e terminar com [`assemble_narrated_video`](https://nodaro.ai/docs/mcp/tools/video-editing#assemble_narrated_video). O assistente carrega uma receita com [`get_recipe`](https://nodaro.ai/docs/mcp/tools/utility#get_recipe) e a segue, uma chamada de ferramenta de cada vez.

## Como as receitas funcionam
`get_recipe` só entrega texto. Como `start_workflow_editor` e `start_video_director`, ela não chama nenhuma outra ferramenta e não muda nada. As ações que uma receita pede, como `generate_video`, `generate_speech` ou `assemble_narrated_video`, são chamadas de ferramenta comuns: cada uma precisa da própria permissão e custa os próprios créditos.

A ferramenta não precisa de permissão e não custa nada, em todas as edições. Ela responde a três tipos de chamada:

| Chamada | O que retorna |
| --- | --- |
| `get_recipe` sem argumento | O catálogo: o nome, a descrição e as frases de ativação de cada receita |
| `get_recipe` com `recipe` | As instruções completas dessa receita, por exemplo `recipe: "video-explainer"` |
| `get_recipe` com `recipe` e `file` | Um arquivo de referência que acompanha a receita, por exemplo `file: "references/prompts.md"` |

Uma receita ou um arquivo desconhecido retorna um erro que lista os nomes de receita válidos.

## O catálogo
| Receita | O que produz | Exemplos de frases de ativação |
| --- | --- | --- |
| `camera-coverage` | Dez ângulos de câmera de uma cena, prontos para montar, a partir de um único quadro de referência. Uma lista de tomadas editável é aprovada antes de qualquer gasto, e um nó de imagem se desdobra em todas as tomadas. | “cobertura de câmera”, “lista de tomadas”, “ângulos diferentes da mesma cena” |
| `image-editing-levers` | Edições paralelas de uma imagem em alta resolução: instruções de texto precisas, visuais definidos com seletores, trocas de fundo com iluminação compatível, um avaliador opcional e uma folha de contatos | “edite esta imagem”, “mude a cor da jaqueta”, “remova o fundo” |
| `infinite-zoom` | Um único avanço contínuo da câmera através de vários clipes gerados, cada um terminando dentro de um detalhe em que o seguinte começa, unidos quadro a quadro. Também há uma versão com zoom em imagens fixas, que não gasta créditos de geração. | “zoom infinito”, “zoom sem fim”, “zoom no detalhe” |
| `instagram-carousel` | Um carrossel completo do Instagram a partir de uma ideia: uma imagem 9:16 por slide, com o texto na imagem, um texto de introdução e uma legenda | “carrossel do instagram”, “post em carrossel”, “transforme isto em um carrossel” |
| `multi-reference-control` | Uma imagem composta a partir de até cinco referências, cada uma contribuindo com algo diferente, como uma pessoa, uma peça de roupa ou um lugar | “combine várias referências”, “pegue a jaqueta da” |
| `one-character-any-scene` | A mesma pessoa colocada em qualquer cena, roupa ou fundo com tokens de referência, sem máscaras nem treinamento de modelo | “mesmo personagem em outra cena”, “mantenha o fundo e troque a pessoa” |
| `person-node-basics` | Um personagem criado a partir dos atributos do seletor **Pessoa** (Person), como idade, porte físico, olhos e cabelo, em vez de texto corrido | “crie uma pessoa”, “crie o visual de um personagem”, “rosto específico” |
| `podcast-editing` | Uma gravação longa enxugada, ou cortada em um pacote de clipes curtos, a partir da transcrição, por meio de uma lista de edição que você pode ajustar antes de renderizar com `apply_edl` | “edite meu podcast”, “limpe esta gravação”, “pacote de clipes” |
| `product-photoshoot` | Uma campanha publicitária completa, em nove estilos de anúncio, a partir de uma imagem do produto: da sua própria foto do produto ou de uma referência de visual reescrita para o seu produto | “ensaio fotográfico de produto”, “anúncios para o meu produto” |
| `scene-chain-reel` | Um reel vertical cinematográfico a partir de várias cenas: primeiro as imagens fixas, com uma cadeia de referências para manter a continuidade; um único prompt de movimento para todos os quadros; uma trilha de fundo; e depois corte e formatação | “reel cinematográfico”, “reel do instagram”, “vídeo com várias cenas” |
| `song-from-reference` | Uma música parecida com uma que já existe. A faixa de outra pessoa é analisada e transformada em uma música original; um cover com Suno só é feito a partir de áudio que é seu. | “música parecida”, “faça um cover desta música”, “faça uma música a partir deste link” |
| `suno-music-basics` | Músicas e instrumentais estilizados com combinações de seletores de música, como gênero, clima, instrumentação e voz | “faça uma música”, “faixa instrumental”, “música para o meu vídeo” |
| `video-explainer` | Um vídeo explicativo animado, narrado e não fotorrealista: um estilo visual fixo, vários blocos de narração renderizados como clipes sem som e uma única voz, montados com `assemble_narrated_video` | “vídeo explicativo”, “vídeo explicativo animado”, “vídeo de como funciona” |

No Nodaro Cloud, o catálogo também inclui um vídeo UGC sobre um site: um criador falando para a câmera sobre um site, com as capturas de tela dele mostradas como cartões. Essa receita usa as [ferramentas de criação de vídeos UGC](https://nodaro.ai/docs/mcp/tools/utility#the-ugc-video-builders).

## Imagens animadas ou motion graphics
O Nodaro pode fazer um vídeo explicativo de duas formas, e a receita `video-explainer` pede que você escolha antes de qualquer outra coisa:

| | Receita `video-explainer` | [Diretor de vídeo](https://nodaro.ai/docs/mcp/video-director) |
| --- | --- | --- |
| **Imagem** | Imagens animadas geradas, cenas ilustradas | Tipografia cinética, formas e imagens |
| **Como** | O assistente executa cada etapa, e você pode revisar cada clipe e cada take de voz | Uma chamada a `create_explainer`, ou o pipeline de sequência de tomadas, etapa por etapa |
| **Custo** | As gerações de cada bloco de 10 segundos, então cresce com a duração | Um conjunto fixo de etapas por vídeo |

Se você escolher motion graphics, a receita para e passa a vez para `start_video_director`. Se o seu pedido já indicar um estilo, a receita pula a pergunta.

## Adicionar uma receita à sua instância
Em uma instalação self-hosted, e em contribuições para o repositório público, uma receita é uma pasta com um arquivo `RECIPE.md` no diretório `skills/recipes` do backend, mais uma pasta opcional `references` para os arquivos que a receita carrega com `file`. O servidor lê o catálogo quando inicia.

```text
skills/recipes/my-recipe/
RECIPE.md
references/
prompts.md
```

`RECIPE.md` começa com um frontmatter em YAML, seguido das instruções que o assistente recebe, escritas como um briefing direto: primeiro as regras, depois as fases, com os nomes e os parâmetros exatos das ferramentas.

```markdown
---
name: my-recipe
description: One line shown in the catalog
triggers: ["phrase one", "phrase two"]
version: 1
---

# My recipe

You are producing ONE ...
```

| Campo | Obrigatório | Observações |
| --- | --- | --- |
| `name` | Sim | Deve ser igual ao nome da pasta. O nome da pasta é o que `get_recipe` carrega, e os dois não são comparados entre si. |
| `description` | Sim | Uma linha para o catálogo. |
| `triggers` | Sim | Frases que um usuário poderia dizer. Não coloque vírgulas dentro de uma frase: a lista é separada nas vírgulas. |
| `version` | Não | Um número a aumentar quando as instruções mudam muito. |

O nome da pasta precisa estar em kebab case: letras minúsculas, dígitos e hífens. Uma receita com campos faltando fica de fora do catálogo, sem afetar as outras. Um arquivo de referência só pode ser lido de dentro da pasta da própria receita. Para testar uma receita, chame `get_recipe` sem argumento, depois com o nome da receita e depois com cada arquivo de referência.

## Frequently asked questions

### O que é uma receita de conteúdo no Nodaro?

Um guia testado que diz a um assistente de IA como chegar a um resultado com várias ferramentas do Nodaro, passo a passo, como um vídeo explicativo animado com narração ou um carrossel do Instagram. O assistente carrega a receita com get_recipe e a segue.

### Carregar uma receita custa créditos?

Não. get_recipe só retorna instruções. As gerações que a receita pede são chamadas de ferramenta comuns, cada uma com o próprio preço e a própria permissão.

### Qual é a diferença entre a receita video-explainer e create_explainer?

A receita video-explainer faz um vídeo explicativo com imagens animadas geradas, e o assistente controla cada clipe e cada take de voz. create_explainer faz um vídeo explicativo de motion graphics, com texto e formas, em uma chamada. A receita pergunta primeiro qual dos dois você quer.

### Como meu assistente sabe qual receita usar?

get_recipe sem argumento lista todas as receitas com as frases de ativação delas, como “vídeo explicativo” ou “ensaio fotográfico de produto”. O assistente associa seu pedido a uma receita antes de montar qualquer coisa.