# Incorporações

> As duas formas de levar o Nodaro ao seu produto: um miniapp que executa um workflow publicado e o viewport de cena 3D sem estado, e quando usar cada uma.

Source: https://nodaro.ai/pt-BR/docs/developers/embed

As **incorporações** colocam uma parte do Nodaro dentro do seu próprio produto. Existem duas, e elas resolvem problemas diferentes. A **incorporação de miniapp** executa um workflow publicado para os seus usuários, e o **viewport de cena 3D** mostra uma cena 3D, e opcionalmente a edita, sem executar nada.

## Qual incorporação escolher
| | Miniapp | Viewport de cena 3D |
| --- | --- | --- |
| **O que faz** | Executa um miniapp publicado: coleta as entradas, inicia uma execução e mostra o resultado. | Desenha um plano de cena 3D: o viewport, a reprodução, a lista de objetos, os editores de pose e o histórico de revisões. |
| **Como incorporar** | Sua própria interface sobre a API REST, ou um iframe com o código de incorporação do miniapp. | Um iframe em `/embed/scene3d`, controlado por `postMessage`. |
| **Autenticação** | Sua própria interface usa um token de API pessoal ou um token OAuth, guardado no seu servidor. O iframe usa a própria sessão do Nodaro de quem está vendo a página. | Nenhuma. O iframe não tem sessão e não faz nenhuma chamada de rede. |
| **Créditos** | Cada execução custa créditos, pagos pela conta em nome da qual a execução é feita. | Nunca. O visualizador não executa nenhum job. |
| **Onde fica o estado** | As execuções ficam armazenadas no Nodaro. | Sua página guarda a cena. O iframe não guarda nada de um carregamento para outro. |

## Quando incorporar um miniapp
- Você publicou um workflow como miniapp, e seus usuários devem executá-lo a partir do seu site ou do seu app. Veja [Apps](https://nodaro.ai/docs/concepts/apps).
- Você quer seu próprio formulário e seu próprio visual em volta do app. Crie os dois sobre a API REST.
- Você quer o caminho mais rápido. Cole o código de incorporação do miniapp na sua página.

Leia [Incorporar um miniapp](https://nodaro.ai/docs/developers/embed/miniapps).

## Quando incorporar o viewport de cena 3D
- Seu produto armazena planos de cena 3D, vindos de jobs de [**Gerar cena 3D** (Generate 3D Scene)](https://nodaro.ai/docs/nodes/video/generate-3d-scene) e de [**Editar cena 3D** (Edit 3D Scene)](https://nodaro.ai/docs/nodes/video/edit-3d-scene), e seus usuários devem vê-los.
- Seus usuários devem reproduzir uma cena, percorrer a linha do tempo e selecionar objetos nela, no modo somente leitura por padrão.
- Seus usuários devem editar poses, cores e bloqueios, e sua página salva cada nova revisão.

Leia [Incorporar o viewport de cena 3D](https://nodaro.ai/docs/developers/embed/scene3d) e, para os dados que o viewport desenha, [Formato de cena 3D](https://nodaro.ai/docs/developers/embed/scene3d-format).

## As duas mantêm os tokens fora do navegador
Nenhuma das incorporações coloca um token do Nodaro na sua página web. Quando você cria sua própria interface de miniapp, o token fica no seu servidor. O viewport de cena 3D nunca leva um token nas mensagens: sua página busca os assets da cena com a própria sessão e envia os bytes.

## Frequently asked questions

### O que posso incorporar do Nodaro?

Duas coisas. Um miniapp, que é um workflow publicado com um formulário simples, e o viewport de cena 3D, que desenha um plano de cena 3D enviado pela sua página.

### Qual incorporação do Nodaro executa gerações de IA?

Só a incorporação de miniapp. O viewport de cena 3D não executa nada, não tem sessão, não faz nenhuma chamada de rede e nunca gasta créditos.

### Preciso de um token de API para incorporar o viewport de cena 3D?

Não. O viewport não precisa de token nem de sessão. Sua página envia a cena com postMessage e busca os assets binários da cena com a própria sessão.

### Onde fica o token quando eu crio minha própria interface para um miniapp?

No seu servidor. O código que roda no navegador se comunica com o seu servidor, e o seu servidor chama a API do Nodaro com o token. Assim, o token nunca chega ao navegador.