Tripo CLI: deja que la IA convierta texto e imágenes en modelos 3D

Tripo CLI está diseñada para agentes de IA y hace que la creación 3D sea tan sencilla como chatear. Ya sea en una herramienta de programación con IA como Codex, Claude Code o Cursor, o usando la CLI directamente, basta una descripción en lenguaje natural, una imagen o un modelo existente para generar o transformar modelos 3D, animaciones y otros recursos. La CLI completa todo el flujo automáticamente, sin que necesites entender APIs, versiones de modelos ni parámetros complejos.

¿Debo usar la CLI o la API?

Tripo se ofrece en dos variantes; dedica diez segundos a elegir la adecuada:

Producto	Ideal para	Adónde ir
Tripo CLI (esta página)	Principiantes: accede rápidamente a las capacidades de IA 3D mediante las herramientas populares de vibe coding	Sigue leyendo
Tripo API	Desarrolladores profesionales: integra las capacidades de IA 3D en sitios web, aplicaciones o tus propios sistemas de negocio	Inicio rápido

¿No lo tienes claro? Empieza por esta página: instalar es gratis y los créditos solo se gastan cuando generas un modelo de verdad.

Instalación e inicio de sesión (elige una de las dos rutas)

Elige una de las dos rutas de instalación siguientes.

Ruta uno: dejar que la IA lo instale por mí (recomendada)

Si ya usas Cursor, Claude Code, Codex u otro asistente de IA capaz de ejecutar comandos de terminal, esta es la ruta más sencilla. Copia el prompt de abajo y envíaselo completo a tu asistente:

Configura Tripo CLI por mí y explica cada paso. Comprueba que Node.js 20 o posterior esté instalado y ejecuta npm install -g tripo-cli. Después, pídeme que complete tripo login en el navegador; no me pidas que pegue una API key en el chat. Por último, ejecuta tripo doctor y dime si pasan las comprobaciones de autenticación, red y saldo.

Lo que ocurre a continuación:

La IA revisa tu equipo y, si falta Node.js, te ayuda a instalarlo primero;
La IA ejecuta el comando de instalación;
Te toca a ti: se abre una ventana del navegador con la página de inicio de sesión de Tripo; inicia sesión y aprueba el código de verificación que aparece en tu terminal (este paso debes hacerlo tú; nunca envíes ninguna clave a la IA);
La IA ejecuta tripo doctor; cuando todas las comprobaciones pasen, la configuración está lista.

Después, salta directamente a la siguiente sección, «Crea tu primer modelo 3D».

¿Problemas? La IA se ha atascado o ha encontrado un error

Pega el error del terminal tal cual a la IA y deja que continúe; puede resolver la mayoría de los problemas;
El inicio de sesión no se ha completado: vuelve a abrir la página de inicio de sesión y comprueba bien el código de verificación que aparece en tu terminal antes de aprobar;
Si nada funciona, recurre a la «Ruta dos: instalarlo por mi cuenta» de abajo; son solo tres comandos.

Ruta dos: instalarlo por mi cuenta

¿No tienes asistente de IA? No pasa nada: todo el proceso son tres comandos.

Paso 1: instala Tripo CLI

Este comando instala el comando tripo en tu equipo:

Bash

npm install -g tripo-cli

Normalmente el progreso termina sin texto de error en rojo, lo que significa que la instalación se ha completado correctamente.

¿Problemas? No se encuentra npm o hay un error de permisos

No se encuentra npm: Node.js aún no está instalado. Instala la versión LTS actual (20 o posterior) desde el sitio web de Node.js, después vuelve a abrir el terminal e inténtalo de nuevo;
Error de permisos en macOS (EACCES): ejecuta sudo npm install -g tripo-cli en su lugar e introduce la contraseña de tu equipo cuando se te pida;
Windows dice que «la ejecución de scripts está deshabilitada»: vuelve a abrir PowerShell como administrador e inténtalo de nuevo.

Paso 2: inicia sesión en tu cuenta de Tripo

Bash

tripo login

Tu navegador abre automáticamente una página de autorización (si aún no tienes cuenta, regístrate ahí primero). La página muestra un código de verificación: apruébalo solo después de confirmar que coincide con el código que aparece en tu terminal. Tras iniciar sesión, el terminal confirma que has entrado en tu cuenta.

Página de autorización de dispositivo de Tripo CLI en el navegador con un código de verificación

¿Problemas? El navegador no se ha abierto o el inicio de sesión no se ha completado

El inicio de sesión no se ha completado: ejecuta tripo login otra vez y aprueba solo después de comprobar bien el código que aparece en tu terminal;
El navegador no reacciona: copia manualmente en tu navegador la URL impresa en el terminal;
La autorización en el navegador no está disponible temporalmente: la CLI abre en su lugar la página de la API key; consulta «Inicio de sesión alternativo y regiones» al final de esta sección.

Paso 3: comprueba que todo está listo

Bash

tripo doctor

Comprueba, por orden, el estado de tu inicio de sesión, el acceso a la red y el saldo de créditos. Cuando las tres comprobaciones pasen, la configuración está lista.

¿Problemas? Una de las comprobaciones ha fallado

Falla la autenticación: el inicio de sesión no se completó; ejecuta tripo login e inicia sesión de nuevo;
Falla la red: confirma que tu equipo puede abrir páginas web; las redes corporativas o de campus pueden necesitar un proxy;
Falla el saldo: no tienes créditos suficientes; no se ha empezado a generar nada y no se cobra nada. Ejecuta tripo topup para abrir la página de facturación.

Inicio de sesión alternativo y regiones (solo si el inicio de sesión en el navegador no está disponible)

Si ya tienes una API key, ejecuta tripo login --key tsk_... o define la variable de entorno TRIPO_API_KEY;
Una API key es una credencial de tu cuenta: nunca la pegues en chats, código fuente, capturas de pantalla ni registros;
La misma instalación funciona tanto con cuentas internacionales como de China continental: la CLI prueba ambas regiones con tu clave y guarda automáticamente la región que la acepta.

Crea tu primer modelo 3D

Paso 1: genera a partir de una frase

Las palabras entre comillas son tu prompt; sustitúyelas por lo que quieras crear:

Bash

tripo make "a cute low poly fox"

Mantén el terminal abierto mientras se ejecuta el comando. Tripo CLI elige el flujo y el modelo adecuados, espera a que la tarea termine y descarga los archivos en una carpeta tripo-out dentro del directorio actual. Todo el proceso suele terminar en unos minutos y cuesta una pequeña cantidad de créditos.

¿Problemas? La generación no ha empezado o ha fallado a medio camino

Créditos insuficientes: tu modelo no ha empezado a generarse y no se cobra nada. Ejecuta tripo topup para añadir créditos y vuelve a intentarlo;
Error de red: asegúrate de que tu equipo tiene conexión y ejecuta el mismo comando otra vez;
La tarea ha fallado: los créditos cobrados se reembolsan automáticamente; prueba con una descripción diferente.

Paso 2: abre la vista previa

Bash

tripo view @last

@last significa «la tarea más reciente». Tu navegador abre una vista previa 3D interactiva que puedes girar arrastrando; cuando veas tu modelo, ¡lo has conseguido!

Después del primer éxito: lo que tienes ahora

Dónde están los archivos: una carpeta nueva dentro de tripo-out contiene el modelo 3D descargado y task.json, que registra cómo se creó la tarea; si el servidor proporciona una imagen de vista previa, también tendrás preview.png.
Ábrelo de nuevo: ejecuta tripo view @last en cualquier momento, o tripo view <file> para abrir cualquier archivo de modelo.
Cuánto ha costado: ejecuta tripo balance para consultar tu saldo de créditos.
¿No quieres memorizar comandos? Ejecuta simplemente tripo para abrir un menú interactivo guiado; ahí encontrarás inicio de sesión, generación, vista previa y recarga de créditos.
Próximos pasos: genera a partir de imágenes (siguiente sección), deja que un asistente de IA se encargue («Deja que los agentes de programación con IA dominen la CLI») o procesa por lotes («Flujos preparados y procesos»).

Genera a partir de una imagen o de un modelo existente

Cuando el ejemplo de texto funcione, puedes pasar archivos locales en su lugar. Los nombres concept.png, front.png y hero.glb de abajo son ejemplos; sustitúyelos por las rutas de tus propios archivos:

Bash

tripo make concept.png --for print
tripo make front.png back.png
tripo make hero.glb --then texture,rig
tripo make @last --then convert:fbx

Línea 1: convierte una imagen de concepto en un modelo listo para imprimir;
Línea 2: genera a partir de las imágenes frontal y trasera juntas para lograr un detalle más preciso;
Línea 3: texturiza y aplica rigging a un modelo existente;
Línea 4: convierte el resultado más reciente a FBX.

Deja que los agentes de programación con IA dominen la CLI

Si no usas un agente de programación con IA, omite esta sección. El paquete npm incluye una Agent Skill —referencias de comandos, recetas para distintos escenarios y guía de recuperación de errores— para que un agente pueda usar la CLI correctamente. Pídele al agente que ejecute estos comandos para imprimir en el terminal las instrucciones completas o un tema concreto:

Bash

tripo docs --llm
tripo docs --topic commands/make
tripo docs --topic examples/game-asset

Archivos incluidos en la Skill

skill/
├── SKILL.md
├── common-errors.md
├── commands/
│   ├── account.md
│   ├── batch.md
│   ├── generate.md
│   ├── make.md
│   ├── process.md
│   ├── task.md
│   └── view.md
└── examples/
    ├── animation.md
    ├── ar-web.md
    ├── film.md
    ├── game-asset.md
    ├── pipes.md
    └── print.md

Referencia de comandos

No hace falta memorizar esta tabla: en el día a día, quien empieza solo necesita tripo (menú interactivo), tripo make (generar), tripo view (vista previa) y tripo doctor (comprobación de estado). Despliega el resto solo cuando surja una necesidad concreta.

Mostrar la tabla completa de comandos y las opciones comunes

Comando	Función
`tripo make <input...>`	Genera, procesa y descarga con un solo comando
`tripo ai [description]`	Planifica un trabajo, lo confirma y lo ejecuta
`tripo view [task\|file]`	Abre una vista previa 3D local e interactiva
`tripo redo [task]`	Repite una solicitud con una semilla nueva
`tripo login / logout / whoami / use`	Autoriza y cambia entre perfiles de cuenta con nombre
`tripo topup / balance / usage`	Abre la facturación regional y consulta los créditos
`tripo generate <endpoint>`	Accede de forma explícita a los ocho endpoints de generación
`tripo model / anim / mesh <step>`	Ejecuta refinamiento, texturizado, rigging, conversión, segmentación y otros pasos de procesamiento
`tripo task get/list/watch`	Consulta, enumera o espera tareas
`tripo history [--limit <n>]`	Muestra el historial local de tareas recientes
`tripo files upload <path>`	Sube un archivo y devuelve su `file_token`
`tripo batch run <manifest.yaml>`	Ejecuta procesos masivos reanudables con concurrencia y reintentos
`tripo config / doctor`	Gestiona la configuración y diagnostica el entorno local
`tripo docs [--topic <topic>]`	Imprime la documentación incluida para agentes y comandos
`tripo mcp`	Ejecuta la CLI como servidor MCP
`tripo completion <shell>`	Genera el autocompletado para Bash, Zsh o Fish

Los comandos make, ai y generate, junto con los subcomandos de procesamiento de model, anim y mesh, admiten -o/--out, --no-wait, --no-download, --name, --timeout, --notify y la opción repetible --param key=value. Las opciones globales de automatización incluyen --json, --yes, --quiet, --no-open y --profile.

Flujos preparados y procesos

Esta es una sección avanzada; tu primera generación no la necesita. Siete presets integrados aplican de una sola vez parámetros y pasos de procesamiento útiles mediante --for <preset>:

game-mobile · game-pc · film · print · ar-web · anim · toy

Bash

# Mobile game asset: low-poly generation, texture, then FBX
tripo make "sci-fi crate" --for game-mobile

# Print asset: watertight output, STL, and a flat bottom
tripo make "chess knight" --for print

# Explicit processing chain
tripo make cat.png --then texture,rig,convert:fbx

# The same chain as NDJSON pipes
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Resumable batch processing
tripo batch run assets.yaml --concurrency 2

Las referencias a tareas como @last, @2 y @name funcionan en cualquier lugar donde se acepte un ID de tarea.

Varias cuentas y regiones

Si solo utilizas una cuenta de Tripo, omite esta sección. Las credenciales se almacenan en perfiles con nombre, por lo que iniciar sesión en una segunda cuenta no sobrescribe la primera:

Bash

tripo login
tripo login --profile work-cn
tripo use
tripo whoami
tripo make "a fox" --profile work-cn
tripo logout

Cada perfil conserva su propia clave y región. La variable de entorno TRIPO_PROFILE selecciona un perfil para el entorno actual, mientras que TRIPO_API_KEY omite todos los perfiles y tiene la máxima prioridad.

Notas para agentes de programación con IA

Los usuarios humanos pueden omitir esta sección. Estas reglas ayudan a un agente de programación con IA a esperar las tareas correctamente y a leer la salida legible por máquina.

tripo make y tripo task watch son comandos que bloquean la ejecución. Espera a que termine el proceso en lugar de implementar otro bucle de consulta.
Con --json, la mayoría de los comandos de ejecución única escriben una línea JSON final en stdout. En cambio, tripo task watch --json transmite eventos de progreso NDJSON seguidos del resultado final.
Si existe preview.png, revísalo antes de decidir si continúas un proceso o ejecutas tripo redo.
No inventes parámetros ni fuerces versiones antiguas de los modelos. Utiliza tripo docs --topic ... para consultar las opciones compatibles.
Una solicitud low-poly o un presupuesto de 20 000 caras o menos selecciona tripo-p1; el resto de trabajos utiliza tripo-v3.1 de forma predeterminada.

Mostrar la tabla de códigos de salida

Código de salida	Significado
`0`	Correcto
`1`	Error inesperado o interno
`2`	Uso o parámetros no válidos
`3`	Error de autenticación
`4`	Créditos insuficientes
`5`	Rechazo por la política de contenido
`6`	La tarea ha fallado; los créditos se reembolsan automáticamente
`7`	Error de red
`8`	Recurso no encontrado
`9`	Límite de solicitudes alcanzado; vuelve a intentarlo con espera incremental

Variables de entorno para automatización

No necesitas variables de entorno para el uso interactivo normal; existen para CI, scripts y flujos avanzados con agentes. Recuerda: nunca hagas commit de una API key en un repositorio, ni la pegues en la documentación, ni la incluyas en capturas de pantalla o registros.

Mostrar la tabla de variables de entorno

Variable	Finalidad
`TRIPO_API_KEY`	API key; tiene la máxima prioridad y es adecuada para CI o agentes
`TRIPO_PROFILE`	Perfil de cuenta con nombre, equivalente a `--profile`
`TRIPO_REGION`	Sustitución opcional por `ov` o `cn`; normalmente se detecta automáticamente
`TRIPO_API_BASE_URL`	Sustitución del endpoint de la API
`TRIPO_PLATFORM_BASE_URL`	Sustitución del endpoint de la plataforma
`TRIPO_HOME`	Directorio de configuración e historial; el valor predeterminado es `~/.tripo`
`TRIPO_LLM_BASE_URL`	Endpoint opcional compatible con OpenAI para `tripo ai`
`TRIPO_LLM_API_KEY`	Clave LLM opcional para `tripo ai`
`TRIPO_LLM_MODEL`	Modelo LLM opcional para `tripo ai`