Esta página describe la primera versión del paquete. Para la versión 0.3, con todos los estudios, claves API y aprobación del precio, consulta la nueva guía de instalación.
El comando yesilcam abre los estudios a los scripts. Todo lo que pulsas en la aplicación lo puedes ejecutar desde una shell, con salida JSON para la siguiente herramienta de la cadena. Usa tu cuenta habitual y el mismo monedero de créditos, así que un script y un compañero que trabaja en la aplicación nunca ven saldos ni precios distintos. Así es como la usamos, junto con el puñado de reglas que evitan que la producción automatizada te dé sorpresas.
Instala e inicia sesión una vez
El paquete es yesilcam-studios, instalado de forma global con npm. Ejecuta yesilcam login y después yesilcam balance para confirmar que el monedero es visible. El token se guarda en ~/.config/yesilcam/config.json con permisos solo para el propietario; yesilcam logout lo elimina. Mantén el token en privado, porque da acceso completo a la cuenta, y no subas el archivo de configuración a ningún repositorio.
Los comandos que realmente usarás
yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.pnggenera una imagen en un nivel y la guarda.yesilcam video --from 1234 --duration 5 --waitanima un recurso existente y espera el resultado.yesilcam tryon --garment 88 --person 77 --out look.pngejecuta una prueba virtual de un recurso de prenda sobre una modelo.yesilcam assets upload file.pngsube un archivo a tu biblioteca y devuelve su id.yesilcam maket analyze plan.dxfinforma de lo que contiene un plano;yesilcam maket create "Villa"yyesilcam maket save ground.dxf --project 12 --floor 0archivan planos en proyectos.
Añade --json a cualquiera de ellos para obtener una salida legible por máquina. Ese indicador es la razón de ser de la CLI: convierte cada estudio en un paso de una cadena que tú controlas.
Un catálogo nocturno
El bucle que ejecutamos para un cliente de moda es así: para cada foto de prenda de una carpeta, se sube con yesilcam --json assets upload, se lee el id del recurso en el JSON y luego se ejecuta yesilcam --json tryon con ese id de prenda y el id de la modelo, con --wait y una ruta de salida con el nombre del archivo de la prenda. Por la mañana, una carpeta de fotos de prendas se ha convertido en una carpeta de looks, cada uno con su procedencia anotada en el registro con los mismos id de trabajo que imprimió el JSON. Los colores nuevos llegan a la carpeta y se procesan la noche siguiente sin que nadie abra la aplicación.
Storyboards a partir de un guion
Divide un guion en prompts de escena, uno por línea, y recórrelos en bucle con yesilcam image en el nivel Draft, con archivos de salida numerados. Revisa la carpeta como una tira. Después vuelve a ejecutar solo los que te quedes en el nivel Standard. La pasada en Draft cuesta una fracción de la pasada Standard, y la revisión se hace en un explorador de archivos en lugar de en una cola, que es como preferimos mirar treinta fotogramas a la vez.
Comprobación de planos en CI
yesilcam maket analyze plan.dxf --json devuelve muros, puertas, ventanas y estancias. Haz fallar la compilación si un plano no tiene estancias o si sus unidades se supusieron. Un estudio de arquitectura que exporta sus DXF desde una plantilla puede detectar un esquema de capas roto antes de que nadie suelte el archivo delante de un cliente, y la comprobación tarda un segundo.
Reglas que mantienen honestos a los scripts
- Ejecuta los trabajos en secuencia cuando necesites sus id en orden. La cola se comparte con la aplicación; un script que lanza veinte trabajos en paralelo los recibe de vuelta en el orden en que vayan terminando.
- Comprueba primero el saldo.
yesilcam balance --jsonantes de un lote, y detente si no alcanza. Un script que vacía el monedero a las tres de la madrugada es un script que deja a medias un lote. - Usa Draft para todo lo que vayas a revisar antes de quedártelo. La automatización hace que sea fácil gastar en Standard por defecto. No lo hagas.
- Guarda los id de trabajo. Son la manera de encontrar el recurso en la biblioteca, la forma en que el registro explica un cargo y el modo de rastrear un reembolso si un trabajo falló.
- No analices la salida para humanos. Siempre
--json. El formato para humanos es para los ojos y puede cambiar.
Lo que no hace la CLI
No se salta los precios ni el monedero; cada operación cuesta lo mismo que en la aplicación, con el multiplicador de tu plan aplicado. No ejecuta la conversión 3D de Maket, que ocurre en el navegador; analiza y archiva planos. Y no reintenta por ti los trabajos fallidos. Los fallos se reembolsan automáticamente y el JSON te dice qué trabajo falló, pero la decisión de volver a ejecutarlo es tuya.
Preguntas frecuentes
¿Pueden dos personas compartir un token de la CLI? No deberían. El token da acceso completo a la cuenta de la que procede. Cada persona inicia sesión con su propia cuenta, y el monedero del que gasta es el suyo.
¿Un script ve los mismos precios que la aplicación? Sí. La CLI, la aplicación, las herramientas MCP y la página de precios leen la misma tabla en vivo, así que hay un único precio por operación en todas partes.
¿Adónde van los resultados? A tu biblioteca, igual que desde la aplicación, y a la ruta que indiques con --out. Nada de lo que genera un script queda oculto para la aplicación.
