# Recast

> Peça a um assistente de IA que escreva um filme como roteiro em JSON, valide-o de graça, importe-o como projeto de recast e renderize após aceitar o preço.

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

O **Recast** é o caminho do MCP para fazer um vídeo completo a partir de um único pedido. O assistente escreve o filme como um roteiro em JSON no formato de roteiro de cinema e valida o roteiro de graça. Depois, importa-o como um projeto de recast real, que você pode ver e retomar em [recast.nodaro.ai](https://recast.nodaro.ai), e o renderiza com o preço exibido antes de cada gasto. Prefira este caminho para pedidos de ponta a ponta, como “faça um vídeo, um filme ou um anúncio sobre X”. Para um workflow no canvas, use as [ferramentas de workflow](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) ou o [Film Director](https://nodaro.ai/docs/mcp/film-director). O Recast é um recurso do Nodaro Cloud.

## O ciclo
### Ler o guia de criação
`get_recast_authoring_skill` retorna o guia do formato do roteiro, gerado a partir do planejador que a própria plataforma usa. Ele traz o formato do documento, o significado de cada campo, os valores permitidos, os limites, as regras de áudio e um exemplo completo já validado. Gratuito.

### Validar quantas vezes precisar
`validate_recast_script` verifica o roteiro de graça. Corrija cada erro no `path` indicado, usando o `hint` dele, e repita até `valid` ser `true`.

### Importar o roteiro
`import_recast_script` cria o projeto de recast e o workflow dele, e armazena o roteiro como uma análise concluída. Gratuito. A ferramenta exige `rights_attested: true`, que precisa refletir a sua própria confirmação, na conversa, de que o roteiro é obra sua. Ela retorna o `recastId` e o link do projeto.

### Cotar e depois renderizar
`start_recast` sem `confirm` retorna só a cotação em créditos. Depois que você aceita o preço, o assistente chama a ferramenta de novo com `confirm: true`. A renderização roda no servidor. Quando o status mostra `planned`, chamar `start_recast` de novo leva a execução para a renderização, sem nova cobrança.

### Acompanhar a renderização
`get_recast_status` informa o status: em planejamento, planejado, gerando (partes prontas do total, com uma prévia ao vivo), concluído (com a URL do resultado) ou com falha, e sempre traz o link do projeto. Em clientes que exibem MCP Apps, a ferramenta mostra um cartão ao vivo com uma barra de progresso, a prévia que vai crescendo e as escolhas interativas como botões.

## O roteiro
O roteiro tem três partes: `meta`, `slots` para as pessoas, os objetos e os lugares recorrentes, e `scenes`. O guia de criação é a referência; estas são as regras de que os assistentes mais precisam:

- **`visual` é um prompt de geração** para a imagem da cena. **`camera` descreve só o movimento da câmera.** `shotType` vem de uma lista fixa de valores.
- **As cenas duram no máximo 8 segundos** e se seguem a partir do segundo 0, sem intervalos. O filme inteiro vai de 4 segundos até o limite de execução da plataforma.
- **A proporção** é `"16:9"` ou `"9:16"`.
- **Letras cantadas pertencem a uma camada `music`**, nunca a `speech`. Uma cena sem camada de música é silenciosa.

O validador também aceita uma análise completa exportada de [`video_analysis`](https://nodaro.ai/docs/mcp/tools/analysis-and-edl#video_analysis), que tem o mesmo formato cena a cena.

## Direitos e renderização fiel
Um recast criado por você é renderizado **fielmente**: exatamente como está escrito, inclusive com nomes de marcas. É por isso que a importação exige `rights_attested: true`, e é por isso que esse valor precisa vir da sua própria confirmação explícita de que o roteiro é obra sua ou de que você detém os direitos. Um assistente nunca pode definir esse valor em seu nome.

## Escolher o elenco você mesmo
Inicie a execução com `interactive: true` para escolher antes da renderização. O modo interativo tem um acréscimo no preço, que faz parte da cotação. A execução pausa em pontos de decisão; `get_recast_status` mostra os candidatos, e `resolve_recast_gate` registra cada escolha, de graça, e faz a execução avançar. Os pontos de decisão aparecem nesta ordem:

1. **Elenco.** Escolha o retrato de cada elemento, entre três.
2. **Folha de identidade**, para pessoas, quando a execução a oferece. As três folhas têm o rosto que você escolheu; assim, esta escolha é sobre o corpo e as roupas.
3. **Imagens das cenas.** Escolha os quadros de abertura e de fechamento de cada cena.
4. **Música.** Escolha o take de cada trecho de música.

`finish_auto: true` resolve todos os pontos de decisão restantes com o melhor candidato do avaliador automático. Uma execução interativa que ninguém conclui fica em espera com segurança e se resolve sozinha no prazo.

## Permissões
| Ferramenta | Permissão |
| --- | --- |
| `get_recast_authoring_skill`, `validate_recast_script` | Nenhuma |
| `import_recast_script` | `workflows:write` |
| `start_recast`, `resolve_recast_gate` | `workflows:execute` |
| `get_recast_status` | `workflows:read` |

Os parâmetros de cada ferramenta estão na [referência de ferramentas](https://nodaro.ai/docs/mcp/tools/recast).

## Pela API REST
O mesmo caminho funciona pela API REST: `POST /v1/video-analysis/import/validate`, `POST /v1/video-analysis/import` e `GET /v1/video-analysis/authoring-skill`. Veja [Recast](https://nodaro.ai/docs/developers/api/recast) na referência da API.

## Frequently asked questions

### O que é o caminho do recast?

A forma como um assistente de IA faz um vídeo completo a partir de um único pedido. Ele escreve um roteiro em JSON no formato de roteiro de cinema, valida de graça, importa como um projeto de recast real e renderiza, mostrando o preço antes de gastar qualquer crédito.

### Onde posso ver o projeto de recast?

Em recast.nodaro.ai. Toda resposta de status tem um link para ele. O editor completo de lá permite trocar o elenco dos personagens, refazer partes e fazer as escolhas interativas.

### Qual pode ser a duração de um recast?

Cada cena dura no máximo 8 segundos, e as cenas se seguem a partir do segundo 0, sem intervalos. O filme inteiro vai de 4 segundos até o limite de execução da plataforma, em 16:9 ou 9:16.

### O que acontece se eu sair da conversa durante uma renderização?

Nada se perde. A execução é um projeto de recast real, e o app a retoma, ou a deixa em espera com segurança, sem o assistente.

### Por que o assistente me pede para confirmar que o roteiro é meu?

Um recast criado por você é renderizado exatamente como está escrito, inclusive com nomes de marcas. A importação precisa da sua própria confirmação de que o roteiro é obra sua, ou de que você detém os direitos, e o assistente nunca pode dar essa confirmação por você.