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ência | Abra quando você estiver | Linhas |
|---|---|---|
| configuração | instalando ou fazendo login, adicionando o servidor MCP, trabalhando no Linux ou tentado por outra rota do Tripo | 146 |
| imagens | criando as imagens de entrada para um modelo que deve corresponder a uma imagem alvo e tendo-as revisadas | 123 |
| geração | escolhendo um modelo ou parâmetros, usando várias imagens, encadeando as próprias etapas do Tripo ou contando créditos | 146 |
| blender | corrigindo um modelo gerado, trabalhando em um Blender ao vivo ou ajustando essas etapas na construção de um projeto | 283 |
| erros | lendo o código de saída de um comando falho ou um erro de script do Blender | 43 |
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.
-
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).
-
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 -wSem uma chave, o login pelo navegador em configuração também funciona.
-
Blender 5.x, com
blenderno 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:
- 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;
- crie de duas a oito novas candidatas para cada vista, a frente primeiro, e as outras vistas a partir da frente aprovada;
- 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;
- 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.
| Modelo | Flag | Estimativa de simulação | Use para |
|---|---|---|---|
| H3.1 | --model tripo-v3.1 | 10 a 50 créditos; uma imagem com mapas PBR detalhados custa 40 | Objetos sólidos detalhados: estátuas, adereços, rochas |
| P2 (padrão) | --model tripo-p2 | 100 a 130 créditos; uma imagem simples custa 110 | Topologia 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 topupe 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.