Cenas 3D

As ferramentas de cena 3D criam cenas de massinha editáveis e animadas, com geometria simples e movimento por quadros-chave, revisam essas cenas e as renderizam em vídeo. A renderização então serve de guia de layout e de movimento para um modelo de vídeo. Esta página lista os parâmetros de cada ferramenta; Cenas 3D explica o ciclo de trabalho e como ler os resultados.

Todas as ferramentas precisam da permissão workflows:execute e retornam um ID de job. Leia o resultado com get_job ou wait_for_job.

generate_3d_scene

Cria uma cena de massinha editável e animada a partir de um prompt e de referências opcionais. Ela não faz um vídeo fotorrealista. Funciona como o nó Gerar cena 3D (Generate 3D Scene).

Permissão: workflows:execute. Créditos: como o nó Gerar cena 3D, de 11 a 44.

Retorna: um ID de job. O output_data.scenePlan do job concluído é a cena, com o revisionId dela.

edit_3d_scene

Revisa uma cena e mantém a revisão anterior dela. Envie um prompt, que o planejador aplica, ou operações, que são aplicadas diretamente, sem chamar um LLM. Funciona como o nó Editar cena 3D (Edit 3D Scene).

Permissão: workflows:execute. Créditos: como o nó Editar cena 3D, de 0 a 44.

Retorna: um ID de job. O output_data do job concluído contém o novo scenePlan e um changeSummary. Um MP4 sozinho não é uma cena editável: para reconstruir uma cena a partir de um vídeo, use generate_3d_scene com o vídeo como referência.

render_3d_scene

Renderiza uma revisão exata de uma cena em MP4 com o mecanismo do Renderizar vídeo (Render Video). Nenhum LLM é executado. A câmera, a duração e o quadro vêm do plano da cena.

Permissão: workflows:execute. Créditos: conforme o tamanho do quadro no plano: 55 até 1920 pixels no lado maior, 83 acima disso até 5,12 megapixels e 138 para um quadro maior.

Retorna: um ID de job. O resultado é uma URL de vídeo. Defina width e height no plano de forma deliberada: uma cena de 2560 por 2560 custa 2,5 vezes uma de 1920 por 1080, enquanto 1920 por 1920 custa o mesmo que 1920 por 1080. Renderizar vídeo tem a tabela de preços completa.

pro_3d_render

Produz uma tomada 3D pronta num único job: o job concluído traz o plano da cena, o MP4 e uma imagem fixa por tomada. Só aparece na lista de ferramentas nas implantações que têm um mecanismo para ela. Funciona como o nó Renderização 3D Pro (3D Render Pro).

Permissão: workflows:execute. Créditos: cotados e cobrados na mesma chamada. A criação e cada passada de correção são trabalhos pagos; uma simples exportação de uma cena existente não tem custo de criação. Somente no Nodaro Cloud.

Retorna: um ID de job. O output_data do job concluído traz scenePlan, videoUrl e shotStills, uma imagem fixa por tomada, cada uma { shotIndex, frame, assetId, url }. Não há parâmetro de modelo nem de raciocínio: o planejador é fixo.