Renderização 3D Pro

O nó Renderização 3D Pro (3D Render Pro) cria uma cena 3D animada a partir de um briefing e a renderiza, em uma só execução, em um mecanismo de build hospedado. Uma execução retorna o MP4 pronto, a cena exata da qual ele foi renderizado e uma imagem fixa por tomada. É um nó diferente do Gerar cena 3D (Generate 3D Scene): esse nó é uma pré-visualização barata e editável, de massinha, cujo MP4 vem de uma execução separada do Renderizar vídeo (Render Video).

O Renderização 3D Pro só é executado no Nodaro Cloud, e só enquanto o mecanismo 3D do Cloud o oferece. As edições self-hosted não oferecem este nó.

Quando usar

• Você quer uma tomada 3D pronta a partir de um briefing, em uma etapa, e não uma pré-visualização para renderizar depois.
• Você quer exportar de novo uma cena existente, sem pagar para criá-la de novo.
• Você quer uma imagem fixa por tomada, para usar como referência de imagem em gerações posteriores.
• Você quer um quadro largo em 21:9, que o Gerar cena 3D não oferece.

Onde está disponível

• Menu Adicionar nó. No Nodaro Cloud, o nó fica em Vídeo › Títulos, gráficos e legendas › Renderização 3D Pro enquanto o mecanismo 3D o oferece. Quando o mecanismo não está disponível, o nó simplesmente não aparece na lista, em vez de aparecer desativado.
• API e SDK. GET /v1/3d-scene/capabilities informa pro.available. Onde o nó não está disponível, GET /v1/nodes o deixa de fora, e uma requisição é recusada com 503 SCENE_CAPABILITY_UNAVAILABLE. Ele nunca recorre ao mecanismo Básico.
• MCP. A ferramenta pro_3d_render só aparece na lista onde o nó pode ser executado, então a presença dela na lista de ferramentas é a verificação.

Um workflow que já contém o nó mantém a cena e o vídeo guardados se o mecanismo for desativado depois. Só as novas execuções são recusadas.

Início rápido

A origem da cena

Toda execução tem exatamente uma origem, e a origem decide o que acontece e o que você paga.

Uma Instrução de edição (opcional) vazia é o que faz uma execução ser só de renderização. Pela API, deixe o campo editPrompt de fora para uma exportação simples: uma string vazia é uma requisição diferente.

Uma quarta origem, uma exportação concluída de um Blender de desktop pareado, está disponível pela API onde a instalação a suporta.

Entradas

Saídas

Conecte os nós de vídeo a Vídeo, e não a Composição: a composição é uma cena, não um vídeo.

As imagens fixas são uma folha de contatos, e não uma segunda renderização. Elas saem da mesma execução, sem custo extra. Uma cena de uma única tomada tem exatamente uma imagem fixa, no quadro 0. Use-as para enviar o quadro de abertura de uma tomada a um modelo de imagem ou de vídeo, ou para revisar a marcação tomada por tomada sem percorrer o MP4.

As imagens fixas funcionam em qualquer entrada de imagem. As imagens fixas ficam guardadas de forma privada. Quando você conecta a saída Shot stills a uma entrada de imagem ou de referência, o Nodaro dá ao modelo uma leitura de curta duração da imagem fixa exata de que ele precisa. A leitura vale só para aquela execução e se baseia no seu próprio acesso. O link expira minutos depois e nunca é guardado.

Configurações

Não há configuração de modelo nem de raciocínio: o planejador é fixo e executado pelo Nodaro. O estilo é de massinha.

O timing de uma cena existente. Uma cena já tem a própria duração, a própria taxa de quadros e a própria proporção, e uma execução as mantém. Marque Redefinir o tempo desta cena para mudá-las de propósito. Uma mudança que não cabe na cena é recusada, em vez de ser aplicada sem aviso.

Usar o resultado como referência de vídeo

O MP4 é uma referência de layout, como a renderização do Gerar cena 3D. Ele traz as posições, a oclusão, o enquadramento, o movimento de câmera e o timing, e também um visual cinza de massinha que um modelo de vídeo copia, a menos que seja instruído a não fazer isso.

• O Nodaro adiciona a linha de escopo. Conecte a saída Vídeo à entrada Refs. de vídeo de um nó Gerar vídeo (Generate Video). O Nodaro então adiciona uma linha que diz ao modelo para copiar só o layout e ignorar o visual de massinha. Em uma cena com várias tomadas, a linha também cita os pontos de corte.
• Um personagem por figura. O tratamento fotorrealista segue cada assunto referenciado. Dê a cada figura que precisa parecer real a própria referência de personagem e deixe dois espaços de referência livres para um local ou uma imagem de estilo.
• Você é avisado sobre figuras sem referência. Quando uma execução do workflow encontra mais pessoas na cena do que referências de personagem, ela continua, porque você pode querer figuras de massinha. Ela registra um aviso scene3d_unreferenced_figures no job, com o número de figuras sem referência e se uma referência por figura cabe no limite de referências do modelo.
• Nunca como quadro inicial. Conecte a renderização a uma entrada de referência. Um quadro inicial define o visual, e nenhuma linha de escopo chega até ele.

Créditos

O Renderização 3D Pro é uma única operação cobrada. Uma cena nova paga a criação, o build hospedado e a renderização. Uma cena existente sem instrução de edição paga só a renderização. Cada passada de correção dentro do orçamento de correções é trabalho pago.

Primeiro a cotação, depois a execução. O preço é definido por cada implantação, então não há um preço de tabela fixo. Toda execução recebe antes uma cotação, e a cotação mostra um teto, não uma cobrança. No canvas, o nó o mostra como Até N créditos. As margens que uma execução não usa são liberadas quando ela é liquidada. Uma instalação sem preço configurado recusa a execução antes de reservar qualquer coisa.

A cotação pode incluir duas margens além das passadas de correção:

Tamanho do quadro e duração. A etapa de renderização é cobrada por quadro de saída, então uma cena mais longa ou uma taxa de quadros maior custa mais. O preço por quadro segue a mesma escala de tamanhos de quadro do Renderizar vídeo. Quadros de até 1920 pixels no lado mais longo usam a tarifa base. Quadros maiores custam 1,5 vez a base até 5,12 megapixels, e 2,5 vezes acima disso.

Renderizar de novo uma cena guardada, pelo Renderizar vídeo ou com Cena existente e sem instrução, é cobrado como uma renderização comum. O trabalho concluído antes de uma falha, como uma passada de correção anterior, é cobrado normalmente.

O que acontece quando uma execução não passa

Uma revisão visual confere a cena montada, e as passadas de correção respondem às objeções dela enquanto o orçamento de correções durar. Uma execução termina de uma destas formas:

Quando uma cena é entregue sem aprovação, a execução é concluída, o MP4 é real e os créditos são cobrados. Use o vídeo como está ou trate a correção da revisão como um briefing de edição: execute Cena existente com essa correção como Instrução de edição, o que paga outra passada de criação. As edições diretas, como mover, mudar a cor ou ocultar objetos, são grátis. Uma cena que ninguém revisou não tem correção para servir de base, e executar o mesmo job de novo cria uma cena nova, então avalie o MP4 você mesmo.

Quando uma execução falha, mas mantém o rascunho, não há MP4, mas o rascunho é uma revisão comum da cena:

• Renderize-o como está. Execute-o como Cena existente, sem instrução. Essa execução paga só a renderização, e as verificações dela não julgam o rascunho de novo.
• Corrija-o você mesmo. As edições diretas se aplicam ao rascunho como a qualquer outra cena e não custam criação.
• Crie de novo a partir dele. Execute-o como Cena existente, com uma instrução de edição.

Manter o rascunho não custa nada. No canvas, o nó mostra o rascunho e a falha juntos, inclusive depois de recarregar a página; assim, ter uma cena no nó nunca significa que a execução passou. Uma edição que você fez enquanto a execução estava em andamento continua valendo, e o rascunho que chega fica guardado no histórico de revisões.

Erros de planejamento

Dicas

• Primeiro a pré-visualização, depois o Pro. Faça a marcação da tomada de forma barata com o Gerar cena 3D e o Editar cena 3D e depois renderize a versão final aqui.
• Exporte de novo sem criar. Para exportar a mesma cena de novo, use Cena existente sem instrução ou conecte Composição ao Renderizar vídeo.
• Diminua o orçamento em rascunhos. Um Orçamento de correções de 0 ou 1 limita o trabalho de correção pago.
• Use as imagens fixas. A imagem fixa de cada tomada é uma referência de imagem pronta para o Gerar imagem (Generate Image) ou o Gerar vídeo.

Pela API

A API usa duas chamadas para um único job pago. POST /v1/pro-3d-render/quote recebe a requisição e retorna um quoteId e o maxCredits, o teto. A cotação não reserva nem gasta nada. Depois, POST /v1/pro-3d-render recebe o mesmo corpo mais o quoteId, com um cabeçalho Idempotency-Key de 8 a 255 caracteres, e retorna um jobId. Um corpo alterado entre as duas chamadas é recusado, assim como uma cotação expirada. Reutilize a mesma Idempotency-Key quando tentar de novo um envio que excedeu o tempo limite.

const caps = await client.scene3d.capabilities();
if (!caps.pro?.available) return; // this install cannot run it

// Author a new scene and render it: quotes and runs in one call.
const shot = await client.scene3d.renderProAndWait({
  source: {
    kind: "prompt",
    prompt: "A red suitcase rolls behind a central pillar and reappears. Dolly right over thirty seconds.",
    references: [{ id: "look", kind: "image", role: "appearance", url: appearanceImageUrl }],
  },
  durationSeconds: 30,
  fps: 24,
  aspectRatio: "21:9",
  maxRepairPasses: 2,
});

// Later: render the same revision again, with no authoring charge.
await client.scene3d.renderProAndWait({
  source: { kind: "scene", revisionId: shot.sceneRevisionId, sourceJobId: shotJobId },
});

• O job concluído traz videoUrl, scenePlan, sceneRevisionId, shotStills (um { shotIndex, frame, assetId, url } por tomada), validation e metadata, com o tamanho do quadro, a taxa de quadros, os quadros e a duração.
• Uma entrega não aprovada adiciona metadata.review. Verifique esse campo e o verdict dele, refused ou unavailable, em vez de validation.status, que é passed nos dois casos.
• Um job com falha e rascunho ainda tem scenePlan, sceneRevisionId e uma validation cujo status é failed.
• Taxa de quadros. Pela API, fps pode ser qualquer valor de 15 a 60.

Os assistentes de IA usam a ferramenta MCP pro_3d_render, que faz a cotação e o envio com os mesmos parâmetros. Veja Cenas 3D pelo MCP e a API de cenas 3D para todos os campos, códigos de aviso e erros.