CommunityImagengithub.com

tripo3d-blender

Crea modelos 3D con Tripo3D y finalízalos en Blender. Tripo3D genera la malla base a partir de un prompt o una imagen, y cada refinamiento fino ocurre en Blender, sin interfaz o en vivo: tamaño, orientación, pivote, limpieza, correcciones esculpidas, repintado, tamaño de textura, niveles de detalle y exportación GLB. Úsalo cuando te pidan generar o hacer un modelo 3D, estatua, accesorio, edificio, roca, personaje o activo de juego a partir de texto o una imagen, o uno que deba coincidir con un concepto artístico o una foto, incluyendo la creación y revisión de las

¿Qué es tripo3d-blender?

Este skill combina Tripo3D para la generación rápida de mallas base (a partir de texto o imagen) con Blender para refinamientos precisos y repetibles. Es útil cuando se necesita un modelo 3D final de alta calidad (estatuas, props, personajes, activos de juego), ya que Tripo3D proporciona la forma base en aproximadamente un minuto, y Blender se encarga de tamaño, orientación, pivote, limpieza topológica, correcciones esculpidas, repintado, tamaño de textura, niveles de detalle (LOD) y exportación a GLB. Soporta macOS, Linux y Windows, y puede funcionar tanto sin interfaz (headless) como con Blender en vivo para iteraciones rápidas. El flujo de trabajo evita pagar múltiples veces por nuevas generaciones en Tripo3D: solo se paga una vez por la malla base (usando `tripo-cli`), y todas las correcciones se realizan en Blender mediante scripts que garantizan resultados idénticos en cada reconstrucción. El skill incluye referencias detalladas para configuración, generación de imágenes de entrada, selección de modelos (H3.1 para objetos sólidos detallados, P2 para topología limpia), dry-runs para estimar costos, y una guía completa de refinamiento en Blender con herramientas headless y en vivo.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Modelos Tripo3D, finalizados en Blender

Tripo3D convierte una imagen o un prompt en una malla texturizada en aproximadamente un minuto. Cada ejecución consume créditos, sus controles son gruesos y una nueva versión del modelo produce una malla diferente para la misma solicitud. Blender es gratuito y preciso, y un script da el mismo resultado cada vez. Así que toma la malla base de Tripo3D una vez, mantenla y realiza cada refinamiento en Blender. Paga por una nueva ejecución solo cuando la forma sea incorrecta. Tamaño, orientación, una mano abultada, un tinte de textura y un presupuesto de triángulos son todas correcciones de Blender.

Probado el 2026-11-20 con tripo-cli 0.11.2, Blender 5.3.0 y Node 24 en macOS. Si tripo --version imprime una versión más reciente, confía en tripo docs --topic commands/make en lugar de este archivo para las banderas.

Archivos de referencia

Este archivo lleva un modelo desde la configuración hasta un GLB terminado. Abre una referencia solo cuando la tarea necesite su detalle.

ReferenciaÁbrela cuando estésLíneas
setupinstalando o iniciando sesión, añadiendo el servidor MCP, trabajando en Linux, o tentado por otra ruta de Tripo146
pictureshaciendo las imágenes de entrada para un modelo que debe coincidir con una imagen objetivo, y haciéndolas revisar123
generationeligiendo un modelo o parámetros, usando varias imágenes, encadenando los propios pasos de Tripo, o contando créditos146
blenderarreglando un modelo generado, trabajando en un Blender en vivo, o ajustando estos pasos en la compilación de un proyecto283
errorsleyendo el código de salida de un comando fallido, o un error de script de Blender43

Los dos scripts que este archivo ejecuta están en tools/ junto a él. A continuación, <skill-dir> significa la carpeta que contiene este SKILL.md.

1. Lo que un humano debe hacer primero

Un agente no puede hacer esto. Pídelos antes de ejecutar cualquier cosa.

  1. Una cuenta paga de API de Tripo3D, en https://developers.tripo3d.ai (internacional) o https://developers.tripo3d.com (China continental). Los créditos de API son separados de los créditos de Tripo Studio. El pago importa para los derechos: los términos de Tripo otorgan a los usuarios pagos los derechos sobre sus resultados, incluyendo publicación y venta (sección 5.2.2), y retienen los resultados de los usuarios gratuitos para Tripo (sección 5.2.1).

  2. La clave de API en el almacén secreto del sistema. En macOS, el humano ejecuta esto y escribe la clave en el prompt, para que la clave nunca pase a través del chat:

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

    Sin una clave, el inicio de sesión en el navegador en setup también funciona.

  3. Blender 5.x, con blender en el PATH. El control en vivo también necesita el add-on Blender Lab MCP con Allow Online Access activado; consulta blender.

Nunca preguntes por la clave en el chat, y nunca la escribas en un archivo que crees. Léela desde el almacén secreto en línea, como hace la sección 2.

2. Configurar Tripo3D

Una vez por máquina:

node --version                      # necesita 20 o posterior
npm install -g tripo-cli            # instala el 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                        # cada comprobación "ok": true

tripo login --key prueba ambas regiones, conserva la que acepta la clave y la guarda en ~/.tripo/config.json con modo 0600, por lo que ningún comando posterior necesita la clave. Un saldo cero en tripo doctor es una advertencia, no un fallo.

Usa tripo-cli, la herramienta oficial de Tripo, para cada llamada a Tripo. El servidor Tripo-Developer/tripo-mcp más antiguo se bloquea al inicio y maneja un add-on de Blender que ya no existe. El add-on Tripo Bridge en Blender solo toma modelos que una persona envía desde el sitio web de Tripo. setup tiene el detalle.

3. Generar un modelo base

Elige la entrada. Una imagen del objeto completo, solo, sobre un fondo liso, en vista frontal o de tres cuartos. Dos a cuatro imágenes cubren los lados ocultos; nombra los archivos front, left, back y right. El modelo copia la forma, la superficie y el color de la imagen, por lo que el desgaste, el musgo y el color deben estar en la imagen. Un prompt entrecomillado también funciona, con menos control.

Haz que las imágenes sean revisadas antes de pagar. Un defecto en una imagen vuelve a la malla, y una nueva ejecución cuesta los créditos nuevamente. Cuando el humano da un objetivo, como un concepto artístico o una foto, y quiere que el modelo coincida:

  1. escribe una lista de verificación solo del objetivo: qué muestra cada parte, qué falla, y las proporciones y colores que se pueden medir;
  2. haz de dos a ocho candidatos nuevos para cada vista, primero el frontal, y las otras vistas a partir del frontal pasado;
  3. entrega el objetivo, la lista de verificación y los candidatos a un revisor separado, otro agente o una persona que no los haya hecho, cuyo trabajo es rechazarlos;
  4. ejecuta Tripo3D solo en las imágenes que pasaron, y anota los puntos que el revisor dejó pasar, para el acabado en Blender.

pictures tiene el bucle, cómo instruir al revisor, qué falla en una imagen y cómo medirla.

Elige el modelo. Sin --model, cada ejecución usa P2, que cuesta aproximadamente tres veces más que H3.1.

ModeloBanderaEstimación de dry-runÚsalo para
H3.1--model tripo-v3.110 a 50 créditos; una imagen con mapas PBR detallados es 40Objetos sólidos detallados: estatuas, accesorios, rocas
P2 (por defecto)--model tripo-p2100 a 130 créditos; una imagen simple es 110Topología limpia de baja poligonización, quads

Haz un dry-run. Un dry-run no envía nada y no 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 debe ser true y errors vacío. Cada entrada en warnings es una configuración que el CLI eliminó, por lo que ese requisito no se cumplirá; resuélvelo antes de pagar. generation_credits_estimate es el precio de lista de la generación solamente.

Ejecútalo sin --dry-run. El comando se bloquea hasta que el modelo, preview.png y task.json están en la carpeta -o, luego imprime una línea JSON. Toma la ruta del modelo de su campo model_file, porque el nombre del archivo cambia con las opciones (pbr_model.glb, por ejemplo). Mira preview.png antes de continuar.

Conserva el resultado sin procesar. Los enlaces de descarga caducan después de unos cinco minutos, y una versión posterior del modelo produce otra malla a partir de la misma semilla, por lo que los archivos descargados son la única copia:

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

Haz commit de esa carpeta, o mantenla con los activos fuente del proyecto. Cada paso de Blender lee esta copia y nunca la red, por lo que una reconstrucción da los mismos archivos.

Detente y pregúntale al humano:

  • antes de cualquier ejecución estimada en más de 50 créditos, cualquier ejecución P2, y cualquier lote cuyas estimaciones sumen más de 150 créditos;
  • después del código de salida 4, créditos insuficientes, porque cada reintento falla de la misma manera: dale al humano tripo topup y espera;
  • antes de tripo redo, porque es una nueva ejecución paga con una nueva semilla y sin dry-run.

4. Finalízalo en Blender

Ambos scripts se ejecutan sin ventana y nunca usan la red.

Encuentra el frente. La documentación de Tripo da +x como el eje hacia adelante de un modelo generado. La vista frontal de Blender mira a lo largo de +y y muestra el lado que mira a -y, por lo que girar +x a -y es --turn -90. No todas las mallas siguen el valor predeterminado, así que renderiza el modelo sin procesar primero y mira front.png:

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

Esto escribe front.png, side.png y top.png en aproximadamente dos segundos.

Finalízalo:

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

El script hornea cada transformación en los vértices, une las partes en un solo objeto y fusiona los vértices duplicados. Gira el modelo según --turn grados sobre el eje vertical, lo escala a --height metros, lo centra y coloca su punto más bajo en el suelo. Luego reduce las texturas más largas que --texture texels y escribe statue.glb, más statue-1.glb y statue-2.glb reducidos al 40% y 12% de los triángulos. Su última línea, FINISHED {...}, da el tamaño, las texturas reducidas, y los triángulos y bytes de cada archivo. Solo --height es obligatorio. --turn tiene como valor predeterminado 0, y sin --levels o --texture no hace copias y conserva las texturas.

Renderiza el archivo terminado de la misma manera y mira de nuevo. Si mira en la dirección equivocada, cambia --turn y finaliza de nuevo desde el archivo sin procesar. Nunca rotes el archivo exportado.

Arregla en Blender antes de pagar por una nueva ejecución. Escala, orientación, pivote, recuento de triángulos, tamaño de textura, color, pequeños bultos y agujeros, y partes fusionadas son trabajo de Blender. Vuelve a Tripo3D solo cuando la forma en sí sea incorrecta. blender tiene la tabla.

Usa Blender en vivo para probar cosas, como esculpir una mano o comparar vistas. Cada cambio que se envía se incluye en un script que reconstruye el modelo desde el archivo sin procesar, porque una edición manual no se puede repetir ni revisar, y la siguiente regeneración la pierde. Si el proyecto ya construye sus modelos con scripts de Blender, añade estos pasos a esa construcción en lugar de enviar la salida de este script.

Skills relacionados