CommunityImagemgithub.com

tripo3d-blender

Habilidade para imagens. Crie modelos 3D com Tripo3D e finalize-os no Blender. Tripo3D gera a malha base a partir de um prompt ou imagem, e cada refinamento detalhado acontece no Blender, headless ou ao vivo, como tamanho, orientação, pivô, limpeza, correções esculpidas, repintura, tamanho da textura, níveis de detalhe e exportação GLB. Use quando for solicitado a gerar ou criar um modelo 3D, estátua, adereço, construção, rocha, personagem ou asset de jogo a partir de texto ou imagem, ou que precise corresponder a uma arte conceitual ou foto, incluindo criar e revisar a imagem de entrada.

O que é tripo3d-blender?

Esta skill combina o Tripo3D, uma ferramenta de IA que gera modelos 3D texturizados a partir de uma única imagem ou prompt de texto, com o Blender, um software de modelagem 3D gratuito e de código aberto. O fluxo de trabalho é otimizado para minimizar custos: o Tripo3D é usado apenas uma vez para gerar a malha base, e todos os refinamentos subsequentes (tamanho, orientação, correções de topologia, texturas, níveis de detalhe) são feitos no Blender por meio de scripts headless, garantindo repetibilidade e controle preciso. A skill suporta as plataformas Tripo3D (API paga) e Blender (headless ou com o add-on Blender Lab MCP para controle ao vivo). Ela fornece referências detalhadas para configuração, criação de imagens de entrada, geração de modelos, operações no Blender e tratamento de erros. O processo envolve: configuração da conta e chave API Tripo3D, geração de uma malha base com parâmetros controlados (modelo H3.1 para detalhes ou P2 para topologia limpa), revisão criteriosa das imagens de entrada antes do pagamento, e finalização no Blender com scripts que aplicam transformações, otimizam texturas e geram múltiplos níveis de detalhe para exportação GLB. A skill enfatiza a importância de manter os arquivos brutos do Tripo3D como fonte única e verdadeira, evitando novas execuções pagas a menos que a forma do modelo esteja fundamentalmente incorreta.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hiddentao/tripo3d-blender-skill/tree/HEAD/tripo3d-blender

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Modelos Tripo3D finalizados no Blender

O Tripo3D transforma uma imagem ou um prompt em uma malha texturizada em cerca de um minuto. Cada execução consome créditos, seus controles são grossos e uma nova versão do modelo fornece uma malha diferente para a mesma solicitação. O Blender é gratuito e preciso, e um script fornece o mesmo resultado toda vez. Portanto, pegue a malha base do Tripo3D uma vez, guarde-a e faça todos os refinamentos no Blender. Pague por uma nova execução apenas quando a forma estiver errada. Tamanho, orientação, uma mão irregular, um tom de textura e um orçamento de triângulos são todas correções do Blender.

Testado em 20/11/2026 com tripo-cli 0.11.2, Blender 5.3.0 e Node 24 no macOS. Se tripo --version imprimir uma versão mais recente, confie em tripo docs --topic commands/make em vez deste arquivo para flags.

Arquivos de referência

Este arquivo leva um modelo da configuração até um GLB finalizado. Abra uma referência apenas quando a tarefa precisar de seu detalhe.

ReferênciaAbra quando você estiverLinhas
configuraçãoinstalando ou fazendo login, adicionando o servidor MCP, trabalhando no Linux ou tentado por outra rota do Tripo146
imagenscriando as imagens de entrada para um modelo que deve corresponder a uma imagem alvo e tendo-as revisadas123
geraçãoescolhendo um modelo ou parâmetros, usando várias imagens, encadeando as próprias etapas do Tripo ou contando créditos146
blendercorrigindo um modelo gerado, trabalhando em um Blender ao vivo ou ajustando essas etapas na construção de um projeto283
erroslendo o código de saída de um comando falho ou um erro de script do Blender43

Os dois scripts que este arquivo executa estão em tools/ ao lado dele. Abaixo, <skill-dir> significa a pasta que contém este SKILL.md.

1. O que um humano deve fazer primeiro

Um agente não pode fazer estas coisas. Peça-as antes de executar qualquer coisa.

  1. Uma conta paga da API Tripo3D, em https://developers.tripo3d.ai (internacional) ou https://developers.tripo3d.com (China continental). Os créditos da API são separados dos créditos do Tripo Studio. Pagar é importante para os direitos: os termos do Tripo concedem aos usuários pagantes os direitos sobre suas saídas, incluindo publicação e venda (seção 5.2.2), e mantêm as saídas dos usuários gratuitos para o Tripo (seção 5.2.1).

  2. A chave API no cofre de segredos do sistema. No macOS, o humano executa isto e digita a chave no prompt, para que a chave nunca passe pelo chat:

    security add-generic-password -a "$USER" -s tripo3d-api-key -w
    

    Sem uma chave, o login pelo navegador em configuração também funciona.

  3. Blender 5.x, com blender no PATH. O controle ao vivo também precisa do add-on Blender Lab MCP com Allow Online Access ativado; veja blender.

Nunca peça a chave no chat e nunca a escreva em um arquivo que você criar. Leia-a do cofre de segredos inline, como a seção 2 faz.

2. Configurar o Tripo3D

Uma vez por máquina:

node --version                      # precisa da versão 20 ou superior
npm install -g tripo-cli            # instala o comando `tripo`
tripo login --key "$(security find-generic-password -s tripo3d-api-key -w)" \
  2>&1 | sed -E 's/tsk_[A-Za-z0-9_-]+/tsk_<hidden>/g'
tripo doctor                        # toda verificação "ok": true

tripo login --key tenta ambas as regiões, mantém a que aceita a chave e a salva em ~/.tripo/config.json com modo 0600, então nenhum comando posterior precisa da chave. Um saldo zero em tripo doctor é um aviso, não uma falha.

Use tripo-cli, a ferramenta oficial do Tripo, para toda chamada ao Tripo. O servidor mais antigo Tripo-Developer/tripo-mcp trava ao iniciar e aciona um add-on do Blender que não existe mais. O add-on Tripo Bridge no Blender só aceita modelos que uma pessoa envia do site do Tripo. configuração tem os detalhes.

3. Gerar um modelo base

Escolha a entrada. Uma imagem do objeto inteiro, sozinho, em um fundo simples, em uma vista frontal ou de três quartos. Duas a quatro imagens cobrem os lados ocultos; nomeie os arquivos front, left, back e right. O modelo copia a forma, a superfície e a cor da imagem, portanto, desgaste, musgo e cor devem estar na imagem. Um prompt entre aspas também funciona, com menos controle.

Faça as imagens serem revisadas antes de pagar. Uma falha em uma imagem retorna na malha, e uma nova execução custa os créditos novamente. Quando o humano fornecer um alvo, como arte conceitual ou uma foto, e quiser que o modelo corresponda a ele:

  1. escreva uma lista de verificação a partir apenas do alvo: o que cada parte mostra, o que falha, e proporções e cores que podem ser medidas;
  2. crie de duas a oito novas candidatas para cada vista, a frente primeiro, e as outras vistas a partir da frente aprovada;
  3. forneça o alvo, a lista de verificação e as candidatas a um revisor separado, outro agente ou uma pessoa que não as criou, cuja função é reprová-las;
  4. execute o Tripo3D apenas nas imagens aprovadas e anote os pontos que o revisor deixou passar, para a finalização no Blender.

imagens tem o ciclo, como instruir o revisor, o que reprova uma imagem e como medir uma.

Escolha o modelo. Sem --model, cada execução usa o P2, que custa cerca de três vezes mais que o H3.1.

ModeloFlagEstimativa de simulaçãoUse para
H3.1--model tripo-v3.110 a 50 créditos; uma imagem com mapas PBR detalhados custa 40Objetos sólidos detalhados: estátuas, adereços, rochas
P2 (padrão)--model tripo-p2100 a 130 créditos; uma imagem simples custa 110Topologia limpa e baixa poligonal, quads

Simule. Uma simulação não envia nada e não gasta nada:

tripo make ref.png --model tripo-v3.1 --seed 7 \
  -p face_limit=30000 -p pbr=true -p texture_quality=detailed \
  -p texture_version=v3.5-20260815 -p delight=true \
  --name statue -o tripo-out/statue --dry-run --json

valid deve ser true e errors vazio. Cada entrada em warnings é uma configuração que a CLI removeu, portanto esse requisito não será atendido; resolva-o antes de pagar. generation_credits_estimate é o preço de tabela da geração sozinha.

Execute sem --dry-run. O comando bloqueia até que o modelo, preview.png e task.json estejam na pasta -o, então imprime uma linha JSON. Pegue o caminho do modelo de seu campo model_file, porque o nome do arquivo muda com as opções (pbr_model.glb, por exemplo). Olhe para preview.png antes de prosseguir.

Mantenha o resultado bruto. Os links de download expiram após cerca de cinco minutos e uma versão posterior do modelo fornece outra malha a partir da mesma semente, portanto, os arquivos baixados são a única cópia:

mkdir -p assets/raw/statue
cp tripo-out/statue/* assets/raw/statue/    # modelo, task.json, preview.png

Faça commit dessa pasta ou mantenha-a com os assets de origem do projeto. Cada etapa do Blender lê esta cópia e nunca a rede, portanto uma reconstrução fornece os mesmos arquivos.

Pare e pergunte ao humano:

  • antes de qualquer execução estimada em mais de 50 créditos, qualquer execução P2 e qualquer lote cujas estimativas somem mais de 150 créditos;
  • após o código de saída 4, créditos insuficientes, porque cada nova tentativa falha da mesma forma: forneça ao humano tripo topup e aguarde;
  • antes de tripo redo, porque é uma nova execução paga com uma nova semente e sem simulação.

4. Finalize no Blender

Ambos os scripts são executados sem janela e nunca usam a rede.

Encontre a frente. A documentação do Tripo dá +x como o eixo dianteiro de um modelo gerado. A vista frontal do Blender olha ao longo de +y e mostra o lado que fica voltado para -y, portanto, girar +x para -y é --turn -90. Nem toda malha segue o padrão, portanto, renderize o modelo bruto primeiro e olhe para front.png:

blender --background --factory-startup \
  --python <skill-dir>/tools/preview_model.py -- \
  assets/raw/statue/<model>.glb build/statue-raw --size 640

Ele escreve front.png, side.png e top.png em cerca de dois segundos.

Finalize:

blender --background --factory-startup \
  --python <skill-dir>/tools/finish_model.py -- \
  assets/raw/statue/<model>.glb build/statue.glb \
  --height 6.5 --name statue --turn -90 --levels 0.4,0.12 --texture 1024

O script assa cada transformação nos vértices, une as partes em um único objeto e mescla vértices duplicados. Ele gira o modelo por --turn graus em torno do eixo vertical, escala para --height metros, centraliza e coloca seu ponto mais baixo no chão. Em seguida, ele reduz texturas maiores que --texture texels e escreve statue.glb, além de statue-1.glb e statue-2.glb reduzidos para 40% e 12% dos triângulos. Sua última linha, FINISHED {...}, fornece o tamanho, as texturas reduzidas e os triângulos e bytes de cada arquivo. Apenas --height é obrigatório. --turn padrão é 0, e sem --levels ou --texture ele não faz cópias e mantém as texturas.

Renderize o arquivo finalizado da mesma forma e olhe novamente. Se estiver voltado para a direção errada, altere --turn e finalize novamente a partir do arquivo bruto. Nunca gire o arquivo exportado.

Corrija no Blender antes de pagar por uma nova execução. Escala, orientação, pivô, contagem de triângulos, tamanho da textura, cor, pequenos relevos e furos, e partes fundidas são trabalho do Blender. Volte ao Tripo3D apenas quando a forma em si estiver errada. blender tem a tabela.

Use o Blender ao vivo para testar coisas, como esculpir uma mão ou comparar vistas. Toda alteração que for para produção entra em um script que reconstrói o modelo a partir do arquivo bruto, porque uma edição manual não pode ser repetida ou revisada, e a próxima regeneração a perde. Se o projeto já constrói seus modelos com scripts do Blender, adicione estas etapas a essa construção em vez de enviar a saída deste script.

Habilidades Relacionadas