Docs do NodaroRecast
Parâmetros das seis ferramentas do Recast, que transformam um roteiro de filme em JSON num projeto renderizado, com validação grátis, cotação e elenco.
Disponível em Nodaro Cloud
As ferramentas do Recast transformam um filme escrito como um único roteiro JSON num projeto real do Recast, que é renderizado no Nodaro e abre em recast.nodaro.ai. Esta página lista os parâmetros de cada ferramenta. Recast explica o ciclo de trabalho e o formato do roteiro; leia essa página primeiro.
As ferramentas do Recast só existem no Nodaro Cloud.
| Ferramenta | Permissão | Créditos |
|---|---|---|
get_recast_authoring_skill | nenhuma | Grátis |
validate_recast_script | nenhuma | Grátis |
import_recast_script | workflows:write | Grátis |
start_recast | workflows:execute | O preço cotado, só com confirm: true |
resolve_recast_gate | workflows:execute | Grátis |
get_recast_status | workflows:read | Grátis |
get_recast_authoring_skill
Retorna o guia de criação de um filme escrito em JSON: o formato do documento (meta, slots, scenes), o significado de cada campo, os valores permitidos, os limites, as regras de áudio e um exemplo completo já validado. O guia é gerado a partir do planejador que a própria plataforma usa.
Esta ferramenta não tem parâmetros.
validate_recast_script
Verifica um roteiro escrito, de graça, quantas vezes você precisar. Nunca cobra nada e não salva nada.
| Parâmetro | Tipo | Observações |
|---|---|---|
script | object | Obrigatório. O roteiro escrito, ou uma análise exportada completa. |
Retorna: valid, errors e warnings. Cada erro tem um path, uma message e, normalmente, um hint. Corrija cada um e chame de novo até valid ser true.
import_recast_script
Transforma um roteiro validado num projeto do Recast: cria o projeto e o workflow dele e armazena o roteiro como uma análise concluída. A importação é grátis.
| Parâmetro | Tipo | Observações |
|---|---|---|
script | object | Obrigatório. O roteiro validado. |
rights_attested | boolean | Obrigatório, e somente true. Defina-o só depois que o usuário confirmar na conversa que o roteiro é obra dele ou que ele detém os direitos. |
Retorna: recastId, jobId, warnings e appUrl, o link para o projeto.
start_recast
Faz a cotação e renderiza um Recast importado. Sem confirm, retorna só o preço. Com confirm: true, depois que o usuário aceitou esse preço, compra o planejamento e a renderização. Se for chamada de novo com uma execução em andamento, leva uma execução planned para a renderização sem nova cobrança, ou informa o progresso.
| Parâmetro | Tipo | Observações |
|---|---|---|
recast_id | string | Obrigatório. O recastId de import_recast_script. |
confirm | boolean | true só depois que o usuário aceitar os créditos cotados. |
interactive | boolean | Permite que o usuário escolha o elenco antes da renderização: 3 candidatos por elemento e um ponto de decisão de um entre três. Adiciona um acréscimo à cotação, então pergunte antes de confirmar. |
resolution | string | A resolução de saída. Padrão: 720p. |
segment_pack | string | Como as cenas são agrupadas em partes: scenes-max (padrão, com menos emendas e o mais barato) ou scenes (partes mais curtas). |
anchor_mode | string | Como as partes se conectam: progressive (o quadro inicial de cada parte vem da renderização anterior) ou none (sem condicionamento por quadro; a cotação deixa de incluir o acréscimo do quadro inicial). Omita-o para usar o padrão do servidor. |
provider | string | Uma substituição do modelo de vídeo. Omita-o para usar o padrão do servidor. |
Retorna: a cotação ou o estado da execução.
resolve_recast_gate
Registra a escolha do usuário num ponto de decisão interativo e faz a execução seguir. A escolha em si é grátis: o acréscimo foi aceito com start_recast. As opções são índices, a partir de 0, dos candidatos que get_recast_status mostra.
| Parâmetro | Tipo | Observações |
|---|---|---|
recast_id | string | Obrigatório. O Recast. |
picks | object | O ponto de decisão do elenco ou da folha de identidade: cada ID de slot associado ao índice do candidato escolhido. |
gate | string | A qual ponto de decisão picks responde: cast (padrão) ou sheet. |
segment, anchor_start, anchor_end | integer | O ponto de decisão das imagens fixas das cenas: a cena e os quadros de abertura e de fechamento escolhidos. |
section, music_pick | integer | O ponto de decisão da música: o trecho da música e o take escolhido. |
finish_auto | boolean | Resolve este ponto de decisão e todos os restantes com o candidato mais bem avaliado pelo crítico automático, para que a execução termine sozinha. |
Os pontos de decisão abrem nesta ordem: o elenco, depois as folhas de identidade das pessoas, depois as imagens fixas das cenas e, por fim, a música. No ponto de decisão das folhas, as três folhas compartilham o rosto escolhido no ponto de decisão do elenco, então a escolha é só sobre o corpo e as roupas.
get_recast_status
Retorna o progresso de um Recast: blueprint pronto, em planejamento, planejado, gerando (segmentos concluídos em relação ao total, com uma prévia ao vivo), concluído (com a URL do resultado) ou com falha. Sempre inclui o link para o projeto em recast.nodaro.ai. Nos clientes que exibem MCP Apps, mostra um cartão ao vivo com uma barra de progresso, a prévia que vai crescendo e os candidatos dos pontos de decisão como botões.
| Parâmetro | Tipo | Observações |
|---|---|---|
recast_id | string | Obrigatório. O Recast. |
Quando o status for planned, chame start_recast de novo para começar a renderização.
Perguntas frequentes
Páginas relacionadas
Recast
Recast
Produções do Studio
Análise e listas de edição
Última atualização
Produções do Studio
Parâmetros de cada ferramenta de produção do Studio, da validação grátis do plano à geração de quadros, movimento, voz e trilha, com escopos e cotações.
Cenas 3D
Parâmetros das quatro ferramentas de cena 3D, que criam e revisam uma cena de massinha editável, a renderizam em MP4 ou entregam uma tomada pronta num job.