Tripo3D

Plugins da Tripo

Plugins da Tripo

Use a Tripo diretamente nas ferramentas em que você já cria conteúdo 3D. Escolha o plugin adequado ao seu fluxo de trabalho, baixe-o, conecte uma chave de API da Tripo e gere modelos sem sair do editor.

Plugins compatíveis

Plugin Versão do Tripo Versão compatível Ideal para Download
Unity 1.0.1 Unity 2022+ Gerar e importar recursos de jogos Baixar
Unreal Engine 1.0 5.6.0 Fluxos de trabalho no editor e com Blueprint Baixar
Blender 0.7.3 3.0+ Gerar um modelo-base para continuar editando Baixar
Godot 0.02 4.4+ Fluxos de trabalho no editor e com Node3D Baixar
Cocos Creator 1.0.0 3.8.6+ Criar recursos dentro de um projeto Cocos Baixar
ComfyUI 1.1.21 0.3.14 Fluxos de geração 3D baseados em nós Baixar

Cada plugin oferece um conjunto diferente de recursos da Tripo. Os exemplos abaixo descrevem somente os comportamentos presentes no pacote correspondente.

Casos de uso dos plugins

Unity — Gerar um objeto de jogo

Caso de uso. Crie um recurso provisório ou um ponto de partida para produção ao desenvolver o protótipo de uma cena.

Etapas.

  1. Abra Tools > Tripo API Unity e configure sua chave de API.
  2. Selecione Image to Model, carregue uma imagem e inicie a geração.
  3. Aguarde a conclusão da tarefa e deixe o plugin importar o modelo baixado para o projeto.

Para um fluxo de execução local opcional de Text to Model, o pacote também oferece TripoRuntimeCore:

GetComponent<TripoRuntimeCore>()
  .SetAPIKey("<TRIPO_API_KEY>")
  .SetTextPrompt("a stylized wooden treasure chest")
  .TextToModel();

Resultado. O recurso gerado fica disponível no Unity para configurar materiais, posicioná-lo na cena ou continuar a edição.

Baixar

Unreal Engine — Gerar com Blueprint

Caso de uso. Adicione a geração de modelos a uma ferramenta do editor Unreal ou a um protótipo controlado por Blueprint.

Etapas.

  1. Crie uma tarefa de geração por texto, imagem ou múltiplas vistas usando os nós Blueprint do plugin.
  2. Use os nós de retorno de chamada e de status da tarefa para aguardar a conclusão.
  3. Passe a URL retornada do modelo ao nó de download. A exibição em tempo de execução exige o plugin glTFRuntime separado, documentado no pacote.

Nós Blueprint do Unreal Engine para criar, consultar e baixar modelos da Tripo

Resultado. O modelo gerado pode ser baixado para importação no editor ou enviado a um fluxo de exibição em tempo de execução.

Baixar

Blender — Gerar a partir de uma imagem de referência

Caso de uso. Produza uma malha-base a partir de uma imagem e continue o trabalho de modelagem e materiais no Blender.

Etapas.

  1. Abra View3D > Sidebar > Tripo 3D e conecte sua chave de API.
  2. Escolha a geração de imagem para modelo, forneça a imagem de referência e ajuste opções como limite de faces, textura, PBR ou malha de quadriláteros.
  3. Inicie a geração e aguarde o plugin baixar e importar o resultado.

Resultado. O arquivo GLB ou FBX é importado para o Blender e pode ser editado com as ferramentas de modelagem padrão.

Baixar

Godot — Adicionar um modelo gerado como Node3D

Caso de uso. Gere um objeto 3D no editor Godot ou em um fluxo de execução local e adicione-o à árvore da cena.

Etapas. Configure a chave de API no plugin, crie um nó de entrada e um de tarefa e aguarde a conclusão da tarefa:

O exemplo abaixo usa uma tarefa de texto. Para uma tarefa de imagem, envie a imagem de origem com TripoUploadImage e crie o modelo com TripoImageToModel.

var input = TripoTextToModelInput.new()
input.prompt = "a stylized wooden treasure chest"

var task = TripoTextToModel.new()
task.input = input
add_child(task)

if await task.launch() == TripoTask.TaskError.eSuccess:
    add_child(task.save_to_node())

Resultado. O modelo gerado pode ser visualizado, salvo ou adicionado à cena atual como Node3D.

Baixar

Cocos Creator — Salvar um recurso gerado no projeto

Caso de uso. Crie um modelo a partir de texto ou imagem sem sair do Cocos Creator.

Etapas.

  1. Abra o painel Tripo Model Generator e conecte sua chave de API.
  2. Selecione uma entrada de texto ou imagem, configure as opções de geração e inicie a tarefa.
  3. Aguarde a extensão baixar o modelo concluído para o projeto.

Resultado. O arquivo GLB ou FBX é gravado em assets/resources e pode ser usado pelo projeto atual.

Baixar

ComfyUI — Criar um fluxo de texto para 3D

Caso de uso. Conecte a geração da Tripo a um pipeline existente de imagens ou recursos baseado em nós.

Etapas.

  1. Conecte uma entrada de texto ao nó de geração de modelos da Tripo.
  2. Defina a chave de API, o modo de geração, a versão do modelo e as opções de saída.
  3. Conecte o resultado ao nó de visualização 3D e execute a fila.

Fluxo de texto para 3D no ComfyUI com a visualização de um modelo gerado

Resultado. O modelo é visualizado no fluxo e salvo automaticamente em ComfyUI/output.

Baixar

Instalar e começar

Unity

  1. Baixe e extraia o arquivo ZIP.
  2. Mova o diretório extraído do plugin que contém package.json para o diretório Packages do seu projeto.
  3. Abra novamente o projeto e selecione Tools > Tripo API Unity.

Unreal Engine

  1. Baixe e extraia o ZIP em Plugins/Tripo3D no seu projeto Unreal.
  2. Ative o plugin nas configurações do projeto.
  3. Reinicie o Unreal Editor.

Blender

  1. Abra Edit > Preferences > Add-ons.
  2. Escolha Install from Disk, selecione o ZIP baixado e ative Tripo 3D.
  3. Abra o plugin em View3D > Sidebar > Tripo 3D.

Godot

  1. Extraia o ZIP e copie addons/tripo-godot para o diretório addons do projeto.
  2. Abra Project Settings > Plugins e ative o plugin da Tripo.
  3. Abra o painel da Tripo no editor ou use os nós fornecidos em uma cena.

Cocos Creator

  1. Abra Extension > Extension Manager.
  2. Selecione Project ou Global, clique em + e importe o ZIP baixado.
  3. Ative a extensão e abra o painel Tripo Model Generator.

Consulte o guia de instalação de extensões do Cocos Creator 3.8 para conhecer o fluxo padrão de importação de arquivos ZIP.

ComfyUI

  1. Extraia o ZIP em ComfyUI/custom_nodes/ComfyUI-Tripo.
  2. Instale as dependências pelo ambiente Python do ComfyUI:
Bash
python -m pip install -r ComfyUI/custom_nodes/ComfyUI-Tripo/requirements.txt
  1. Reinicie o ComfyUI e carregue ou crie um fluxo da Tripo.

Configurar uma chave de API

Crie uma chave na página de chaves de API da Tripo e insira-a no plugin selecionado antes de iniciar uma tarefa.

Uma chave de API é uma credencial secreta. Não a envie ao controle de versão, não a inclua em capturas de tela, não a imprima em logs nem a distribua dentro de uma versão pública do cliente. Consulte Autenticação para conhecer as regras gerais da API.

Recursos relacionados