Última actualización: 13 de abril
# Intents del SDK de Node: comandos de CLI para tareas comunes
**Kevin van Zonneveld**
Cofundador · Ámsterdam, Países Bajos · Mostrar bio
[](https://x.com/kvz)[](https://github.com/kvz)
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](/es/docs/sdks/node-sdk.md) 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:
```bash
npx -y transloadit markdown pdf --input ~/code/uppy/README.md --print-urls
```
Y obtener una salida como esta:
```plaintext
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:
```bash
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?
```bash
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](https://github.com/transloadit/node-sdk/blob/main/packages/node/docs/intent-commands.md)o la [documentación del SDK de Node](/es/docs/sdks/node-sdk.md).
## 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. LasInstructions 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](/es/docs/sdks.md).
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](/c/template-credentials/) como `TRANSLOADIT_KEY` y`TRANSLOADIT_SECRET` en `~/.transloadit/credentials`, y todo estará listo:
```bash
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:
```bash
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](https://github.com/transloadit/node-sdk/issues).
[#node-js](/es/blog/tags/node-js.md)[#cli](/es/blog/tags/cli.md)[#integrations](/es/blog/tags/integrations.md)[#ai](/es/blog/tags/ai.md)
### 👩💻 Únete a más de 20k desarrolladores
Suscríbete a nuestro [boletín mensual EN (English)](/newsletters.md) para recibir enlaces directos a 3 artículos exclusivos sobre tecnología y 2 actualizaciones de producto. Ni más ni menos.
Tu email:
Obtén acceso
## Subida y encoding de archivos. Sin complicaciones.
Transloadit optimiza el manejo de archivos para desarrolladores, con la confianza de marcas como Coursera y The New York Times. Somos reconocidos por una API confiable, soporte de primer nivel y un firme compromiso con el código abierto, con proyectos como [Uppy](https://uppy.io) y el protocolo [tus](https://tus.io) que marcan estándares en el procesamiento de archivos.
[Regístrate](/c/)[Agenda una demo](https://survey.typeform.com/to/kRg47Xi5)
No necesitas tarjeta de crédito · 5 GB incluidos en el plan gratuito
Cancela en cualquier momento