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.
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 nenhuma tarefa. |
| 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.
- 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.
Quando incorporar o viewport de cena 3D
- Seu produto armazena planos de cena 3D, vindos de tarefas de Gerar cena 3D e de Editar cena 3D, 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 e, para os dados que o viewport desenha, Formato de cena 3D.
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 recursos da cena com a própria sessão e envia os bytes.
Perguntas frequentes
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 recursos 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.
Páginas relacionadas
Incorporar um miniapp
Incorporar o viewport de cena 3D
Formato de cena 3D
Apps (miniapps)
Última atualização
Catálogos de seletores
Crie seletores do Nodaro em seu app com @nodaro/prompts, converta seleções em trechos de prompt, traduza rótulos, mostre imagens ou leia catálogos via API.
Incorporar um miniapp
Execute um miniapp do Nodaro no seu produto com o código de incorporação ou um formulário próprio na API REST: entradas, execuções, resultados e erros.