Intents del SDK de Node: comandos de CLI para tareas comunes
El SDK de Node ahora incluye comandos Intent: comandos de CLI de alto nivel para realizar con rapidez trabajos comunes de Transloadit.
El SDK de Node ahora incluye comandos Intent: comandos de CLI de alto nivel para tareas comunes de Transloadit. Estos comandos facilitan mucho el uso de Transloadit para trabajos puntuales, sin tener que escribir primero manualmente el JSON de Assembly Instructions.
La idea de dotar a nuestro SDK de Node de algunas funciones prácticas para la línea de comandos surgió de un problema concreto que teníamos. Cuando creamos integraciones duraderas, las Instructions en JSON y los Templates reutilizables son exactamente la abstracción adecuada. Son expresivos, estables y muy apropiados para flujos de trabajo personalizados de varios pasos. Sin embargo, para trabajos rápidos desde la línea de comandos, pueden sentirse como una carga adicional.
En mi trabajo cotidiano como cofundador, me di cuenta de que no recurría a Transloadit cuando quería convertir rápidamente un archivo Markdown a PDF, aunque contamos con un servicio muy competente precisamente para eso.
Así que empecé a preguntarme qué debería poder hacer una integración para que yo recurriera a ella. Anoté los comandos que quería usar y, a partir de ahí, fui retrocediendo hasta llegar a una implementación. Lo llamamos Intents.
Intents está disponible en la CLI de nuestro SDK de Node como una capa adicional de abstracción de alto nivel sobre nuestros componentes fundamentales, como Robots, Assemblies y Builtin Templates.
Mientras que antes la CLI te daba acceso directo a estos componentes fundamentales, la nueva capa Intents no
se organiza en torno a nuestros mecanismos internos, sino en torno a tu caso de uso puntual, con comandos fáciles de deducir como
markdown pdf, markdown docx, image remove-background, image generate y image describe.
Ejecuta trabajos puntuales desde la CLI
Si tus credenciales TRANSLOADIT_KEY y TRANSLOADIT_SECRET están disponibles en el shell, en un archivo
.env local o en ~/.transloadit/credentials, ahora puedes ejecutar:
npx -y transloadit markdown pdf --input ~/code/uppy/README.md --print-urls
Y obtener una salida como esta:
STEP NAME URL
convert README.pdf https://pub-9974528f53db4a839e95f7e6ce9adb68.r2.dev/836b8ecaed114779b02cb99d4540d81f/37053087fe38475ea3fba78d87dbdfd3/9af5485747b446c5ab737b64db23afc4.pdf
Esto significa que puedes usar Transloadit como una herramienta de CLI práctica para trabajos rápidos, en lugar de usarlo exclusivamente como una integración de backend incorporada.
Usa comandos de alto nivel en lugar de JSON para tareas comunes
Intents abarca flujos de trabajo comunes con nombres de comandos breves y predecibles. Estos son algunos ejemplos:
npx -y transloadit image remove-background --input ./photo.jpg --print-urls
npx -y transloadit image generate --prompt "A red bicycle in a studio" --output bicycle.png
npx -y transloadit image describe --input ./hero.jpg --for wordpress --output fields.json
npx -y transloadit markdown docx --input ./plan.md --output plan.docx
O ¿qué te parece la generación de imágenes guiada por una entrada?
npx -y transloadit image generate \
--input ./person1.jpg \
--input ./person2.jpg \
--input ./background.jpg \
--prompt "Place person1.jpg feeding person2.jpg in front of background.jpg" \
--output scene.png
Para consultar la referencia completa, revisa la referencia de comandos Intent en GitHub o la documentación del SDK de Node.
La practicidad como principio de diseño más importante
Intents procura establecer valores predeterminados potentes. Actualmente, image generate todavía usa de forma predeterminada
google/nano-banana-2. El modelo gpt-image-2 de OpenAI, anunciado el 21 de abril de 2026, ya es compatible
a través de --model openai/gpt-image-2, pero mantendremos su uso como opcional hasta que acumule algunas semanas de experiencia en el mundo real
y los usuarios hayan tenido tiempo para determinar si ofrece mejores resultados con una creación de prompts diferente.
Los modelos de imágenes más avanzados cambian demasiado rápido como para mantenerte al tanto de cada novedad diaria. Lo que sí debes esperar de nosotros es que, una vez que un modelo haya demostrado su eficacia en la práctica, actualicemos el valor predeterminado a la opción que, según el consenso, sea la mejor para nuestros usuarios.
Como mencioné, ponemos un gran énfasis en la practicidad. Si omites --output, la CLI hará
un esfuerzo considerable por determinar una ubicación adecuada para el archivo de salida (o mostrará un error). Si hay
un solo archivo de entrada, elige ese directorio. Si hay varios archivos de entrada, elige el
directorio de trabajo actual. Si se trata de una operación sobre un directorio que incluye muchos archivos, procede con más
cautela y hace obligatorio --output. A menos, claro, que prefieras recibir una URL de una ubicación
temporal, en cuyo caso puedes especificar --print-urls.
Para facilitar la lectura, en esta publicación uso la forma larga --output, pero, naturalmente, también hay alias rápidos
como -o.
Usa Intents para trabajos rápidos y JSON para flujos de trabajo personalizados
Intents no reemplaza el modelo de bajo nivel de Transloadit. Las Instructions en JSON siguen siendo la abstracción adecuada a largo plazo para pipelines de medios integrados. Te permiten crear flujos adaptados a tu caso de uso y están diseñadas para guardarse como Templates y reutilizarse muchas veces en producción mediante nuestros SDK.
Pero si eres un guerrero de la línea de comandos (o quizá tu agente lo sea) y necesitas procesar rápidamente algunos archivos multimedia, esto podría ser justo lo que buscas.
Y recuerda que, incluso si tus necesidades de CLI superan las capacidades de Intents, nuestra CLI sigue siendo compatible con
npx -y transloadit assemblies create, por lo que puedes pasar a crear tus propios pipelines de medios
cuando quieras.
Pruébalo
Si ya tienes una cuenta de Transloadit, copia
las credenciales de tu Workspace como TRANSLOADIT_KEY y
TRANSLOADIT_SECRET en ~/.transloadit/credentials, y todo estará listo:
npx -y transloadit --help
De manera opcional, si quieres ayudar a tu agente (Cursor, Codex, Claude Code, etc.) a encontrar estos Intents y darle superpoderes para el procesamiento de medios, puedes instalar nuestras Skills globalmente mediante:
npx -y skills add https://github.com/transloadit/skills -g --all --copy
Espero que esto te facilite mucho la creación y gestión de archivos multimedia. Si falta alguna función o podría ser aún más práctico, avísame en el registro de incidencias de GitHub.