# Renderização 3D Pro

> Crie uma cena 3D animada a partir de um briefing e renderize-a em uma execução, em um mecanismo hospedado: MP4, cena editável e uma imagem fixa por tomada.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/pro-3d-render

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)](https://nodaro.ai/docs/nodes/video/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)](https://nodaro.ai/docs/nodes/video/render-video).

- Found in: Video › Titles, Graphics & Captions
- Output: video
- API type: `pro-3d-render`

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
### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Títulos, gráficos e legendas › Renderização 3D Pro**.

### Escolher a origem da cena
Em **Origem da cena**, escolha **Nova cena a partir de um briefing** e descreva a tomada em **Cena**, com referências, se você tiver. Ou escolha **Cena existente**, conecte uma cena à entrada **Cena** e deixe a **Instrução de edição (opcional)** vazia para só renderizá-la.

### Conferir o orçamento e o quadro
Mantenha o **Orçamento de correções** em 2, ou diminua-o. Em **Configurações**, confira **FPS**, **Duração (s)** e **Proporção**.

### Executar
Clique em **Executar**. O Nodaro faz a cotação da execução e depois a inicia, e o nó mostra o teto como **Até N créditos**. Quando a execução termina, o nó tem o MP4, a cena e as imagens fixas.

Workflow: Uma execução do Renderização 3D Pro fornece uma imagem fixa da tomada para o quadro-chave e um vídeo de layout para a geração final.

- Enviar imagem → Renderização 3D Pro (referências)
- Renderização 3D Pro → Gerar imagem (referências)
- Renderização 3D Pro → Gerar vídeo (refs. de vídeo)
- Gerar imagem → Gerar vídeo (quadro inicial)

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

| **Origem da cena** | O que acontece | O que você paga |
| --- | --- | --- |
| **Nova cena a partir de um briefing** | Cria uma cena a partir do seu briefing e das suas referências e depois a renderiza. | A criação, o build hospedado e a renderização |
| **Cena existente**, sem instrução de edição | Renderiza essa revisão exata da cena. | Só a renderização |
| **Cena existente**, com instrução de edição | Revisa a cena primeiro e depois a renderiza. | A criação, o build hospedado e a renderização |

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
| Entrada | Aceita | O que faz |
| --- | --- | --- |
| **Cena** | A saída **Composição** do Gerar cena 3D, do **Editar cena 3D** (Edit 3D Scene) ou de outro Renderização 3D Pro | A cena existente a renderizar ou revisar. Usada com **Cena existente**. |
| **Referências** | Nós de imagem e de vídeo | Até 8 referências, com no máximo 1 vídeo. As imagens guiam a aparência e o layout, e um vídeo guia o movimento e o layout. Usada com **Nova cena a partir de um briefing**. |

## Saídas
| Saída | O que leva | Conecte a |
| --- | --- | --- |
| **Composição** | A revisão da cena que esta execução produziu | O [Renderizar vídeo](https://nodaro.ai/docs/nodes/video/render-video) ou a entrada **Cena** de outro nó 3D, para exportar de novo sem pagar para criar de novo |
| **Shot stills** | Uma imagem fixa por tomada, na ordem das tomadas: o quadro em que cada tomada abre | Qualquer nó que receba imagens. O conjunto inteiro segue pela conexão, e não só a primeira imagem fixa. |
| **Vídeo** | O MP4 renderizado | Qualquer nó que receba um vídeo |

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
| Configuração | O que faz |
| --- | --- |
| **Origem da cena** | **Nova cena a partir de um briefing** (o padrão) ou **Cena existente**. |
| **Cena** | O briefing de uma nova cena: os objetos, o movimento deles, a câmera e o timing. |
| **Instrução de edição (opcional)** | Para **Cena existente**. Deixe vazia para renderizar a cena como está. Escreva uma mudança para revisá-la antes, o que custa a criação. |
| **Referências** | Um papel para cada referência conectada: **Aparência**, **Layout** ou **Movimento**. Só em cenas novas. |
| **Orçamento de correções** | 0, 1 ou 2 passadas de correção depois da primeira tentativa. O padrão é 2. Cada passada é trabalho pago, e por isso o orçamento fica visível. |
| **Qualidade** | Só aparece quando a instalação oferece mais de um perfil de qualidade. Hoje, o perfil usado é o standard. Fica em **Configurações**. |
| **Redefinir o tempo desta cena (substitui a duração, o fps e a proporção originais)** | Para **Cena existente**. Desativado por padrão, para que a cena mantenha o próprio timing. Fica em **Configurações**. |
| **FPS** | `24` (o padrão), `30` ou `60`. Fica em **Configurações**. |
| **Duração (s)** | De 1 a 60 segundos. O padrão é 10. Fica em **Configurações**. |
| **Proporção** | `16:9` (o padrão), `9:16`, `1:1`, `4:5` ou `21:9`, conforme a instalação oferecer. Fica em **Configurações**. |
| **Texto antes e depois** | Texto adicionado antes e depois do briefing no momento da execução. Veja [Texto antes e depois do prompt](https://nodaro.ai/docs/concepts/prompt-pre-post-text). |

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](https://nodaro.ai/docs/nodes/video/generate-3d-scene#use-the-render-as-a-video-reference). 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)](https://nodaro.ai/docs/nodes/video/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:

| Margem | O que ela cobre |
| --- | --- |
| Novas tentativas de admissão (até 3, só o planejador) | Outra chamada ao planejador quando o mecanismo recusa uma receita antes de montá-la. Sem build e sem renderização. |
| Passadas mecânicas (até 2, sem planejador) | Um build que aplica uma correção encontrada pelo próprio mecanismo, sem chamar o planejador. Ela não gasta as suas 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](https://nodaro.ai/docs/nodes/video/render-video#what-a-3d-scene-render-costs). 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:

| Desfecho | Tem vídeo? | O que significa |
| --- | --- | --- |
| **Entregue** | Sim | Todas as verificações passaram, e a revisão aprovou a cena. |
| **Entregue, com objeções da revisão** | Sim | Todas as verificações obrigatórias passaram, mas a revisão ainda fez objeções quando o orçamento acabou. As objeções vêm com o resultado. |
| **Entregue, sem revisão** | Sim | Todas as verificações obrigatórias passaram, mas a revisão não deu um veredito utilizável, então ninguém avaliou a cena. |
| **Falhou, rascunho mantido** | Não | Uma verificação obrigatória falhou no último build. A cena montada fica guardada como rascunho. |
| **Falhou, nada montado** | Não | O mecanismo recusou todas as receitas. A última receita pode ficar guardada como evidência. |

**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
| Erro | Tentar de novo? | Significado |
| --- | --- | --- |
| `SCENE_PROVIDER_UNAVAILABLE` | Sim, depois de alguns minutos | O provedor do modelo do planejador estava indisponível ou sobrecarregado. O problema não era o briefing. |
| `SCENE_PLANNING_TIMEOUT` | Sim | O planejamento demorou demais. Tente de novo ou encurte o briefing e as referências. |
| `SCENE_PLANNER_OUTPUT_INVALID` | Não sem mudanças | O planejador respondeu, mas a receita dele não pôde ser montada. Simplifique o briefing ou use menos referências. |

## Dicas
- **Primeiro a pré-visualização, depois o Pro.** Faça a marcação da tomada de forma barata com o [Gerar cena 3D](https://nodaro.ai/docs/nodes/video/generate-3d-scene) e o [Editar cena 3D](https://nodaro.ai/docs/nodes/video/edit-3d-scene) 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](https://nodaro.ai/docs/nodes/video/render-video).
- **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)](https://nodaro.ai/docs/nodes/image/generate-image) ou o [Gerar vídeo](https://nodaro.ai/docs/nodes/video/generate-video).

## 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.

```typescript
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](https://nodaro.ai/docs/mcp/3d-scenes) e a [API de cenas 3D](https://nodaro.ai/docs/developers/api/3d-scenes) para todos os campos, códigos de aviso e erros.

## Frequently asked questions

### Qual é a diferença entre o “Renderização 3D Pro” e o “Gerar cena 3D”?

O “Gerar cena 3D” é uma pré-visualização barata e editável, de massinha, e o MP4 dele vem de uma execução separada do “Renderizar vídeo”. O “Renderização 3D Pro” cria uma cena mais detalhada em um mecanismo de build hospedado e retorna o MP4, a cena e uma imagem fixa por tomada em uma só execução.

### Por que não encontro o “Renderização 3D Pro” no menu “Adicionar nó”?

O nó só aparece no Nodaro Cloud, e só enquanto o mecanismo 3D do Cloud o oferece. As edições self-hosted não o oferecem. Quando ele não é oferecido, o nó simplesmente não aparece na lista.

### Quantos créditos o “Renderização 3D Pro” custa?

Não há um preço fixo. Cada execução recebe antes uma cotação, e o nó mostra o teto como “Até N créditos”. O preço depende da origem, do orçamento de correções, do número de quadros e do tamanho do quadro. Renderizar uma cena existente sem instrução de edição paga só a renderização.

### O que significa quando uma cena é entregue sem a aprovação da revisão?

A execução foi concluída e o MP4 é real, mas a revisão visual fez objeções depois que o orçamento de correções acabou ou não conseguiu dar um veredito. Use o vídeo ou transforme a correção da revisão em uma instrução de edição para uma nova passada.

### Para que servem as imagens fixas?

A saída “Shot stills” tem uma imagem por tomada, o quadro em que cada tomada abre, sem custo extra. Use a imagem fixa de uma tomada como referência de imagem quando gerar essa tomada com um modelo de imagem ou de vídeo.