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. Si esto es Windows PowerShell y la ejecución de scripts está deshabilitada, ejecuta Set-ExecutionPolicy -Scope CurrentUser RemoteSigned (no como administrador) y reinténtalo. Antes de iniciar sesión, pregúntame qué sitio usa mi cuenta: el sitio internacional developers.tripo3d.ai (ov) o el sitio de China continental developers.tripo3d.com (cn). No lo deduzcas por mi idioma ni por el método de inicio de sesión. Ejecuta tripo login --region ov o tripo login --region cn según mi respuesta. Transmíteme la URL de verificación y el código de un solo uso, y mantén el comando en ejecución mientras autorizo 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: confirma el sitio de tu cuenta, abre la URL de verificación proporcionada por la IA e introduce o comprueba el código de un solo uso que aparece en el terminal antes de autorizar (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.

¿Ya está instalado? Ejecuta tripo update --check para comprobar si hay una versión más reciente y después tripo update para instalarla.

¿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»: ejecuta Set-ExecutionPolicy -Scope CurrentUser RemoteSigned en PowerShell (no hace falta ser administrador), vuelve a abrir el terminal e inténtalo de nuevo. Hay más ejemplos más abajo en «Windows / PowerShell».

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

Para una cuenta internacional en developers.tripo3d.ai (facturación de Stripe), ejecuta:

Bash

tripo login --region ov

Para una cuenta de China continental en developers.tripo3d.com (Alipay), usa tripo login --region cn en su lugar. En un terminal interactivo, tripo login sin región te pide primero que elijas el sitio de la cuenta.

Tu navegador abre automáticamente la página de autorización del sitio seleccionado (si aún no tienes cuenta, regístrate ahí primero). Introduce o comprueba el código de un solo uso que aparece en tu terminal y luego autoriza. Tras la autorización, la CLI recibe la clave automáticamente y confirma que has iniciado sesión.

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: en un terminal interactivo, la CLI vuelve a la página de la API key. En un agente de IA u otra sesión no interactiva, usa TRIPO_API_KEY con el TRIPO_REGION correcto, ejecuta tripo login --key tsk_... o vuelve a intentarlo en un terminal interactivo; consulta «Inicio de sesión alternativo y regiones» más abajo.

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 TRIPO_API_KEY junto con TRIPO_REGION (ov o cn) para esa cuenta;
Una API key es una credencial de tu cuenta: nunca la pegues en chats, código fuente, capturas de pantalla ni registros;
tripo login --key tsk_... prueba ambas regiones y guarda automáticamente la región que la acepta. Definir TRIPO_API_KEY directamente no realiza esa detección. Antes de la autorización en el navegador, elige explícitamente el sitio: ov para internacional y cn para China continental;
En un agente de IA u otra sesión no interactiva sin clave, --region es obligatorio. La CLI imprime una URL de verificación y un código de un solo uso, y espera a que una persona autorice. Pregunta qué sitio usa la cuenta antes de empezar; no lo deduzcas por el idioma ni por el método de inicio de sesión.

Windows / PowerShell

Los comandos de esta página están escritos para Bash. También funcionan en Windows; PowerShell solo interpreta algunos tokens de forma distinta a Bash o cURL. En PowerShell, usa los ejemplos siguientes en lugar de copiar los bloques de Bash tal cual.

Permitir que se ejecute tripo

npm instala un shim tripo.ps1 que PowerShell bloquea de forma predeterminada:

PowerShell

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Vuelve a abrir el terminal y ejecuta tripo doctor. No hacen falta derechos de administrador. Si prefieres no cambiar la directiva, usa el Símbolo del sistema (cmd.exe).

Entrecomilla @last y las opciones separadas por comas

PowerShell trata @name como sintaxis especial y , como separador de listas:

PowerShell

tripo make "a cute low poly fox"
tripo view '@last'
tripo make hero.glb --then 'texture,rig'
tripo make '@last' --then 'convert:fbx'

El Símbolo del sistema no necesita estas comillas extra.

Variables de entorno

PowerShell

# Solo la ventana actual
$env:TRIPO_API_KEY = "tsk_..."
$env:TRIPO_REGION = "ov"
$env:TRIPO_PROFILE = "work-ov"

# Persistir para tu usuario de Windows
[System.Environment]::SetEnvironmentVariable("TRIPO_API_KEY", "tsk_...", "User")
[System.Environment]::SetEnvironmentVariable("TRIPO_REGION", "ov", "User")

La configuración y el historial están en %USERPROFILE%\.tripo (el equivalente en Windows de ~/.tripo).

Canalizaciones JSON

PowerShell

# PowerShell 7+ (recomendado)
tripo make cat.png --json | tripo model texture --json | tripo anim rig --json

# Windows PowerShell 5.1
$json = tripo make cat.png --json --no-open
$json | tripo model texture --json

Si un prompt que no está en inglés se ve corrupto, usa Windows Terminal o ejecuta chcp 65001 primero.

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 o HTTP 5xx durante el envío: la tarea puede existir ya en el servidor. Comprueba con tripo balance si hay créditos congelados e inspecciona la consola antes de volver a enviar. Si tienes un ID de tarea, reanuda con tripo task watch <task-id> --download;
La espera agotó el tiempo: la tarea puede seguir ejecutándose y se cobrará si tiene éxito. Reanuda con tripo task watch <task-id> --download; no repitas make ni uses redo para recuperarte de un tiempo de espera;
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! En PowerShell, escribe tripo view '@last'.

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 mesh decimate [input]`	Reduce el número de polígonos; v3.0 puede desplegar UVs en la misma tarea
`tripo mesh uv [input]`	Despliega UVs y reasigna texturas, rigging y animación existentes
`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 update [--check]`	Instala la CLI más reciente o solo comprueba si hay una actualización
`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 (no para PowerShell)

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

Retopología y despliegue UV

decimate sigue usando v2.0 de forma predeterminada. Elige v3.0 para el modelo de retopología más reciente; --smart-uv despliega UVs en la misma tarea y solo admite v3.0 (si omites --model con esta opción, se selecciona v3.0).

Bash

tripo mesh decimate hero.glb --model v3.0 --face-limit 5000 --smart-uv
tripo mesh uv hero.glb

El paso independiente uv reasigna las texturas, el rigging y la animación existentes al nuevo diseño UV, y también devuelve un atlas UV. La entrada no debe superar los 80 000 triángulos equivalentes (un quad cuenta como dos triángulos). Para modelos más grandes, reduce primero los polígonos; por ejemplo, tripo make hero.glb --then decimate:20000,uv. En PowerShell, entrecomilla la cadena como 'decimate:20000,uv'.

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 --region ov --profile personal-ov
tripo login --region cn --profile work-cn
tripo use personal-ov
tripo whoami
tripo make "a fox" --profile personal-ov
tripo logout

Cada perfil conserva su propia clave y región. La variable de entorno TRIPO_PROFILE selecciona un perfil para el entorno actual. TRIPO_API_KEY anula la clave guardada, pero no detecta automáticamente su región; al proporcionar una clave mediante el entorno, define TRIPO_REGION para que coincida con la cuenta.

Usa la región que corresponda a cada cuenta. tripo topup abre la página de facturación regional del perfil activo: /billing en el sitio internacional o /billing/recharge en el sitio de China continental.

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.
tripo-p2 es un modelo Preview y debes seleccionarlo explícitamente con --model tripo-p2. Para obtener una salida low-poly en quads, añade -p quad=true; la salida en quads usa FBX y P1 no admite quads. Usa los alias de modelo de la CLI; la CLI los convierte en los valores de modelo fechados que espera la API.
Inspecciona un plan sin subir archivos, crear tareas ni gastar créditos con tripo make "a low-poly robot" --model tripo-p2 --dry-run.
La creación de tareas solo se reintenta automáticamente para HTTP 429. Un error de red, un tiempo de espera o HTTP 5xx puede dejar incierto el resultado del envío; comprueba la cuenta antes de volver a enviar.

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) o la espera agotó el tiempo (la tarea puede seguir ejecutándose; reanuda la observación)
`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.

Las analíticas de uso anónimas están activadas de forma predeterminada para la API oficial internacional y usan un ID de instalación aleatorio. Registran resultados de comandos y metadatos de tareas, incluidos modelo/tipo, créditos/duración, categoría de error, formato de salida/número de archivos y atribución del agente; se excluyen prompts, rutas de archivos, recursos de entrada, API keys y URL de descarga. Los endpoints de China continental y de API personalizada no envían estos eventos. Define TRIPO_ANALYTICS_ENABLED=0 para excluirte.

Mostrar la tabla de variables de entorno

Variable	Finalidad
`TRIPO_API_KEY`	Anula la clave guardada sin detectar su región; úsala en scripts con el `TRIPO_REGION` correcto
`TRIPO_PROFILE`	Perfil de cuenta con nombre, equivalente a `--profile`
`TRIPO_REGION`	Sustitución por `ov` o `cn` para solicitudes API; no reemplaza `login --region` para la autorización del navegador no interactiva
`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_NO_UPDATE_CHECK`	Cualquier valor no vacío (por ejemplo, `1`) desactiva las comprobaciones automáticas de versión al iniciar
`TRIPO_NPM_REGISTRY`	URL del registro para consultas de versión de la CLI; el valor predeterminado es `https://registry.npmjs.org`. La instalación usa la configuración del registro de npm
`HTTPS_PROXY` / `HTTP_PROXY` / `NO_PROXY`	URL de proxy y lista de omisión para solicitudes de red de la CLI; también funcionan los nombres en minúscula
`TRIPO_ANALYTICS_ENABLED`	Define exactamente `0` para desactivar las analíticas de uso anónimas; China continental y los endpoints de API personalizada no envían ninguna
`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`