# Receita de conteúdo

> Descubra por que um post deu certo: gancho, formato, etapas, chamada para ação, som e ritmo, em uma receita reutilizável, como dados estruturados e texto.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/content-recipe

O nó **Receita de conteúdo** (Content Recipe) explica por que um post de rede social deu certo, como uma receita que você pode reutilizar. Ele lê o material do post com um modelo de linguagem e retorna o gancho, o formato, as etapas, por que o post funciona, a chamada para ação, o som e o ritmo. Você recebe a receita como dados estruturados e como texto legível, pronta para o nó [**Ideias de conteúdo** (Content Ideas)](https://nodaro.ai/docs/nodes/video/content-ideas).

- Found in: Video › Analyze
- API type: `content-recipe`

O nó Receita de conteúdo roda só no Nodaro Cloud. Ele não está disponível em instalações self-hosted.

## Quando usar
- Você quer saber por que o vídeo de um concorrente, um post viral ou um anúncio prende a atenção.
- Você quer reutilizar a estrutura de um post que deu certo, para a sua marca, com o nó [Ideias de conteúdo](https://nodaro.ai/docs/nodes/video/content-ideas).
- Você quer rótulos fixos para cada post, como o formato e o tipo de gancho, para ordenar ou direcionar posts em um workflow.
- Você quer comparar vários posts. Faça uma receita por post e entregue todas ao nó Ideias de conteúdo.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Análise › Receita de conteúdo**.

### Entregar o post ao nó
Analise o post com o nó [**Análise de vídeo** (Video Analysis)](https://nodaro.ai/docs/nodes/video/video-analysis) e conecte a saída **JSON das cenas** dele à entrada **Material de origem**. Um post coletado, uma legenda ou uma transcrição em um nó [**Texto** (Text)](https://nodaro.ai/docs/nodes/automate/text) também funcionam.

### Guardar o link do post
Conecte o nó [**URL de vídeo** (Video URL)](https://nodaro.ai/docs/nodes/automate/video-url) que contém o post à entrada **Post de origem**. A receita então cita o post, e cada ideia feita a partir dela leva de volta ao post.

### Executar
Clique em **Executar**. Quando a execução termina, o app mostra “Receita de conteúdo pronta”. O nó mostra o tema, o formato com o nível de confiança, a duração, o ritmo, o gancho, as etapas e os motivos pelos quais o post funciona. Passe o mouse sobre a receita para abrir o texto completo dela ou para copiá-lo.

Workflow: A Análise de vídeo lê o post, e a Receita de conteúdo transforma a análise em uma receita que guarda o link do post. O nó Ideias de conteúdo escreve ideias para a sua marca, e o Gerar roteiro escreve um roteiro por ideia.

- URL de vídeo → Análise de vídeo (vídeo)
- URL de vídeo → Receita de conteúdo (post de origem)
- Análise de vídeo → Receita de conteúdo (material de origem)
- Receita de conteúdo → Ideias de conteúdo (receitas)
- Texto → Ideias de conteúdo (marca)
- Ideias de conteúdo → Gerar roteiro (prompt)

## Entradas
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Material de origem** | Um resultado da Análise de vídeo, ou qualquer nó que forneça texto, JSON ou uma lista, como um nó Texto com uma legenda ou uma transcrição | O material de onde a receita é lida. Obrigatória. |
| **Post de origem** | O nó [URL de vídeo](https://nodaro.ai/docs/nodes/automate/video-url), ou qualquer nó de texto que contenha um link | O link do próprio post. A receita o cita. Um link conectado tem prioridade sobre **Link do post (opcional)**. |

**O link da página, não o arquivo.** A maioria dos nós conectados ao URL de vídeo recebe o vídeo baixado. Já o **Post de origem** recebe o link da página do post, para que a receita possa apontar de volta para o post.

**Um post por execução.** Quando o **Material de origem** recebe uma lista de vários posts, o nó lê o primeiro e avisa isso no próprio nó. Para obter uma receita por post, defina a conexão como **Cada item**. Veja os [modos de conexão](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes).

### Qual material dá a melhor receita
Um resultado da [Análise de vídeo](https://nodaro.ai/docs/nodes/video/video-analysis) dá a melhor receita. Ele traz os tempos, as palavras faladas, o texto na tela e o som, então o gancho e as etapas vêm do que o post realmente faz. Um post coletado ou um texto simples, como uma legenda ou uma transcrição, também funciona. Sem tempos, o nó estima as etapas a partir de um ritmo natural de fala.

## Saídas
| Saída | O que leva |
| --- | --- |
| **JSON da receita** | A receita como dados estruturados. Veja [O que a receita contém](#what-the-recipe-contains). |
| **Texto da receita** | A mesma receita como texto legível. É o que uma pessoa lê, e o que o nó Ideias de conteúdo lê quando a receita chega como texto. |

O nó [Ideias de conteúdo](https://nodaro.ai/docs/nodes/video/content-ideas) aceita qualquer uma das saídas.

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Modelo de IA** | O modelo de linguagem que escreve a receita. O padrão é o Gemini 3.6 Flash. A lista oferece os modelos que conseguem retornar dados estruturados. O nível do modelo define o preço. Veja [Créditos](#credits). |
| **Foco (opcional)** | No que a receita deve prestar atenção especial, por exemplo “o gancho e o ritmo da edição”. Até 2.000 caracteres. |
| **Link do post (opcional)** | O link do post, usado quando nada está conectado ao **Post de origem**. A receita cita o link, e o nó nunca o abre. Enquanto um nó está conectado ao **Post de origem**, o painel mostra “Vem do nó conectado” e o nome desse nó no lugar do campo. |

## O que a receita contém
| Campo | O que contém |
| --- | --- |
| `version` | `1` |
| `source` | De onde a receita veio: `kind` (`video-analysis`, `post` ou `text`) e, quando conhecidos, `url`, `platform`, `handle` da conta, `title` e `language` do post. Esses dados são lidos da entrada, nunca inventados. |
| `hook` | Sobre os 3 primeiros segundos: `spoken` (palavra por palavra, no idioma original), `onScreenText` (palavra por palavra), `visual`, `types` (1 ou 2 mecânicas de gancho, a principal primeiro) e `whyItStops`. |
| `format` | `label`, um formato da lista abaixo, e `confidence`, de 0 a 1. |
| `beats` | A estrutura do post, em ordem. Cada etapa tem um `start` e um `end` em segundos, um `purpose` e uma `description` de uma linha. |
| `whyItWorks` | De 2 a 4 motivos. Cada um tem um `reason` e um `detail` ligado a um momento do post. |
| `cta` | A chamada para ação: o `kind` dela e o `text` palavra por palavra. O texto fica vazio quando o tipo é `none`. |
| `sound` | O `kind` do som e um `detail` curto. |
| `durationSec`, `pace`, `aspect` | A duração em segundos, medida a partir da análise quando há uma. O ritmo, `fast`, `medium` ou `slow`. A proporção, quando conhecida. |
| `topic`, `summary` | O assunto em poucas palavras, e o padrão reutilizável em 2 ou 3 frases. |

Os rótulos e as descrições ficam em inglês. As palavras citadas, como o gancho falado, ficam no idioma do post.

### Listas de rótulos
Todo rótulo vem de uma lista fixa de ids em inglês. Filtros, roteadores e os nós seguintes podem confiar neles. Todas as listas, exceto a de tipos de som, têm `other`, para um post que não se encaixa em nenhuma das outras opções.

- **Formatos:** `talking-head`, `pov`, `skit`, `storytime`, `tutorial`, `listicle`, `before-after`, `transformation`, `demo`, `unboxing`, `reaction`, `comparison`, `myth-vs-fact`, `day-in-the-life`, `challenge`, `hot-take`, `trend-remix`, `testimonial`, `behind-the-scenes`, `other`.
- **Tipos de gancho**, a mecânica do gancho: `question`, `bold-claim`, `result-first`, `problem-callout`, `tease`, `story-open`, `direct-address`, `relatable-moment`, `pattern-interrupt`, `visual-shock`, `text-overlay`, `sound-hook`, `other`.
- **Propósitos das etapas:** `hook`, `setup`, `problem`, `build`, `demo`, `proof`, `reveal`, `payoff`, `twist`, `cta`, `other`.
- **Motivos pelos quais funciona**, o fator por trás de cada motivo: `curiosity`, `emotion`, `humor`, `relatability`, `social-proof`, `novelty`, `utility`, `aspiration`, `controversy`, `satisfaction`, `urgency`, `authority`, `other`.
- **Tipos de chamada para ação:** `none`, `follow`, `comment`, `share`, `save`, `link-in-bio`, `buy`, `sign-up`, `watch-next`, `dm`, `other`.
- **Tipos de som:** `voiceover`, `on-camera-speech`, `trending-sound`, `music`, `ambient`, `silent`, `mixed`.

## Créditos
Uma execução tem um preço fixo, definido pelo nível do modelo de IA:

| Nível do modelo | Créditos por execução |
| --- | --- |
| Econômico, como o Gemini 3.6 Flash (o padrão) | 6 |
| Padrão, como o Claude Sonnet 4.6 | 22 |
| Premium, como o Claude Opus 5 | 39 |

- **Esforço de raciocínio.** Pela API, um `reasoningEffort` de `xhigh` ou `max` sobe a execução um nível, até o Premium. O painel de configurações não tem controle de esforço de raciocínio neste nó.
- **Execuções que falham.** Uma execução que falha é reembolsada. Veja [Créditos](https://nodaro.ai/docs/concepts/credits).
- **A análise é cobrada à parte.** A [Análise de vídeo](https://nodaro.ai/docs/nodes/video/video-analysis) que costuma alimentar o nó é cobrada pela duração do vídeo. No **Pro**, um post de até 60 segundos custa 238 créditos.

Para saber o preço do fluxo completo, do post até os roteiros, veja o nó [Ideias de conteúdo](https://nodaro.ai/docs/nodes/video/content-ideas#credits).

## Dicas
- **Analise o post primeiro.** O gancho e as etapas só são tão bons quanto o material, e a Análise de vídeo fornece o material mais completo.
- **Guarde o link.** Conecte o nó URL de vídeo ao **Post de origem**, para que cada ideia feita a partir da receita leve de volta ao post dela.
- **Use o foco.** Preencha **Foco (opcional)** quando uma parte importa mais, como o gancho ou o ritmo da edição.
- **Misture vários posts.** Faça uma receita para cada post e conecte todas ao nó Ideias de conteúdo. As ideias se distribuem entre os posts.

## Solução de problemas
**A execução para com “conecte primeiro uma análise de vídeo, um post ou um texto”.** Nada utilizável está conectado ao **Material de origem**. Conecte uma Análise de vídeo, um post ou um nó de texto e execute de novo. A execução para antes de qualquer cobrança.

**A execução termina com “Não foi possível criar a receita de conteúdo”.** O modelo não terminou a receita. Os créditos são reembolsados. Execute o nó de novo.

**O nó avisa que leu só o primeiro post.** O **Material de origem** recebeu uma lista de vários posts. Defina a conexão como **Cada item** para fazer uma receita por post.

**A receita não tem link para o post.** Nada foi conectado ao **Post de origem**, e o **Link do post (opcional)** estava vazio. Conecte o nó URL de vídeo ao **Post de origem**, ou cole o link em **Link do post (opcional)**.

## Pela API
O `POST /v1/content-recipe` faz uma receita no Nodaro Cloud. O corpo recebe `source`, o material do post como texto, e os campos opcionais `sourceUrl`, `focus`, `llmModel` e `reasoningEffort`. O material pode ser um resultado da Análise de vídeo como string JSON, um post, uma legenda ou uma transcrição.

```bash
curl -s https://app.nodaro.ai/v1/content-recipe \
  -H "Authorization: Bearer $NODARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
"source": "Caption: three mornings, one mug. Which one is you?",
"sourceUrl": "https://www.tiktok.com/@example/video/7300000000000000000",
"focus": "the hook and the editing rhythm"
}'
```

A resposta é `{ "jobId": "…" }`. Consulte o job periodicamente com `GET /v1/jobs/:id/status` até o status ser `completed`. O `output_data` dele traz a receita como `json` e como `text`. Veja [Jobs](https://nodaro.ai/docs/developers/api/jobs).

Uma requisição que não pode ser executada é recusada com `400` antes de existir qualquer job, então nada é cobrado. Isso acontece com um `source` vazio ou com mais de 300.000 caracteres, um `focus` com mais de 2.000 caracteres, um modelo que não consegue retornar dados estruturados ou um `sourceUrl` que não é um link http ou https.

Não há uma ferramenta MCP nem um método do SDK dedicados. Em um workflow, o tipo do nó é `content-recipe`. Assistentes de IA e código podem adicioná-lo com as [ferramentas de workflow](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) ou com a [API de workflows](https://nodaro.ai/docs/developers/api/workflows).

## Frequently asked questions

### O que o nó Receita de conteúdo retorna?

Uma receita de um post. Ela traz o gancho dos 3 primeiros segundos e por que ele faz a pessoa parar de rolar o feed, e o formato com um nível de confiança. Ela também traz as etapas com tempos, de 2 a 4 motivos pelos quais o post funciona, a chamada para ação, o som, a duração e o ritmo. A receita vem como JSON estruturado e como texto legível.

### O que devo conectar ao nó Receita de conteúdo?

Uma análise do post feita pelo nó “Análise de vídeo” dá a melhor receita, porque traz os tempos, as palavras faladas, o texto na tela e o som. Um post coletado, uma legenda ou uma transcrição também funcionam. Conecte o nó “URL de vídeo” à entrada “Post de origem” para guardar o link do post na receita.

### Quantos créditos o nó Receita de conteúdo custa?

6 créditos por execução em um modelo econômico, como o Gemini 3.6 Flash, o padrão. Um modelo de nível padrão custa 22 créditos, e um modelo premium, 39. Uma execução que falha é reembolsada. A Análise de vídeo que costuma alimentar o nó é cobrada à parte, pela duração do vídeo.

### Posso reutilizar uma receita sem copiar o post original?

Sim. Conecte a receita ao nó Ideias de conteúdo. As ideias dele aproveitam só a estrutura do post, ou seja, o formato, a mecânica do gancho, a ordem das etapas e o ritmo. O modelo que escreve as ideias nunca vê as falas, o texto na tela nem a chamada para ação do post.

### Posso usar o nó Receita de conteúdo em uma instalação self-hosted?

Não. O nó Receita de conteúdo roda só no Nodaro Cloud, e as instalações self-hosted não o oferecem.