Docs do NodaroRecast
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.
Disponível em Nodaro Cloud
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, 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 ou o 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.cameradescreve só o movimento da câmera.shotTypevem 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 aspeech. Uma cena sem camada de música é silenciosa.
O validador também aceita uma análise completa exportada de 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:
- Elenco. Escolha o retrato de cada elemento, entre três.
- 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.
- Imagens das cenas. Escolha os quadros de abertura e de fechamento de cada cena.
- 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.
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 na referência da API.
Perguntas frequentes
Páginas relacionadas
Recast
Recast
Produções do Studio
Análise e listas de edição
Última atualização
Cenas 3D
Crie uma cena 3D de massinha editável com um prompt, revise-a, renderize-a em MP4 e use o resultado como guia de layout e movimento para um modelo de vídeo.
Solução de problemas
Resolva problemas comuns do Nodaro MCP, de URL errada, login com falha e ferramentas ausentes a jobs com falha, uploads e códigos como client_not_allowed.