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 paquete de npm yesilcam-studios te proporciona dos comandos. yesilcam es la interfaz de línea de comandos: todo lo que haces con clics en la aplicación puedes ejecutarlo desde una terminal, con salida JSON para la siguiente herramienta de la cadena. yesilcam-mcp es un servidor Model Context Protocol que permite a Claude manejar los estudios como herramientas. Ambos usan tu cuenta y tu monedero de créditos habitual, de modo que un script y un compañero que trabaja en la aplicación nunca entran en conflicto: comparten la misma cola y el mismo saldo. Esta guía cubre la instalación, el inicio de sesión, los comandos principales, la configuración de MCP y los hábitos que mantienen segura la automatización.

Instalación e inicio de sesión

  1. Instala el paquete de forma global: npm install -g yesilcam-studios.
  2. Inicia sesión una vez: yesilcam login. Te pide las credenciales de tu cuenta y almacena un token de acceso.
  3. Comprueba que ha funcionado: yesilcam balance muestra tu saldo de créditos.

El token se guarda en ~/.config/yesilcam/config.json con permisos de archivo reservados al propietario. Ejecuta yesilcam logout para eliminarlo, por ejemplo antes de entregar un equipo a otra persona. El token otorga acceso completo a la cuenta, incluido el gasto de créditos, así que trátalo como una contraseña: no lo incluyas en commits, no lo pegues en chats compartidos y sustitúyelo cerrando sesión y volviendo a iniciarla si crees que ha podido filtrarse.

Generar desde la terminal

  • yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.png crea una imagen en el nivel Standard y la guarda.
  • yesilcam video --from 1234 --duration 5 --wait inicia un clip de cinco segundos a partir de la imagen 1234 y espera a que termine.
  • yesilcam tryon --garment 88 --person 77 --out look.png ejecuta una prueba virtual con un recurso de prenda y un modelo.
  • yesilcam maket analyze plan.dxf lee un plano e informa de los muros, puertas, ventanas y estancias.
  • yesilcam maket create "Villa", yesilcam maket save ground.dxf --project 12 --floor 0 y yesilcam maket plans 12 reproducen el modelo de proyectos y planos de la aplicación.

Añade --json a cualquier comando para obtener una salida legible por máquina; los identificadores que devuelve son los que se pasan al siguiente comando. --wait bloquea hasta que termina el trabajo en lugar de volver de inmediato con un identificador de trabajo. Cada trabajo cuesta exactamente lo mismo que en la aplicación, con el multiplicador de tu plan aplicado, y los trabajos fallidos se reembolsan del mismo modo.

Patrones de automatización

  • Un catálogo nocturno. Recorre una carpeta de fotos de prendas: sube cada una con yesilcam --json assets upload, lee el identificador del recurso y ejecuta yesilcam --json tryon con --wait y --out. Cuarenta prendas se convierten en cuarenta looks mientras duermes.
  • Storyboards a partir de un guion. Divide un guion en indicaciones por escena y ejecuta en bucle yesilcam image en el nivel Draft hacia una carpeta. Revisa la carpeta y vuelve a ejecutar en Standard solo las que merezca la pena conservar.
  • Comprobación de planos en CI. yesilcam maket analyze plan.dxf --json devuelve los muros, puertas, ventanas y estancias detectados. Haz fallar la compilación si un plano no tiene estancias o si hubo que deducir sus unidades.

Una regla: ejecuta los trabajos uno tras otro, y no en paralelo, cuando necesites sus identificadores en orden. Las ejecuciones en paralelo son válidas para trabajos independientes, pero un script que presupone que el trabajo 2 se creó después del trabajo 1 debe enviarlos de forma secuencial.

Conectar Claude

El servidor MCP expone los estudios como herramientas: crear imágenes y vídeo, ejecutar una prueba virtual, consultar el estado de un trabajo, listar los recursos de la biblioteca, listar los personajes, leer el saldo, obtener presupuestos y analizar o guardar planos de Maket. La configuración requiere dos comandos.

  1. Muestra tu token: yesilcam login --json y copia el campo token.
  2. Registra el servidor en Claude Code: claude mcp add yesilcam -e YESILCAM_TOKEN=<token> -- yesilcam-mcp.

Claude Desktop lee el mismo servidor desde su archivo de configuración; yesilcam mcp muestra el fragmento que debes pegar allí. Una vez conectado, describes el resultado y Claude encadena las llamadas: «Haz el storyboard de estas seis escenas en Draft, enséñame los fotogramas y luego produce en Standard los dos que elija». Crea los trabajos, espera, devuelve las URL y, como dispone de la herramienta de precios, puede presupuestar un coste antes de comprometerlo.

Mantener a una persona en el circuito

El trabajo en Draft puede ser autónomo. La producción en Standard y en Cinema debe esperar a tu confirmación explícita, porque es ahí donde se van los créditos. Indícalo en tus instrucciones («pregunta antes de cualquier trabajo por encima de Draft») y Claude preguntará. Lo mismo se aplica a los scripts: pon el nivel en una variable, con Draft como valor predeterminado, y haz que los niveles superiores requieran una opción explícita. Comprueba el saldo antes de un lote largo y recuerda que el monedero se comparte con la aplicación, de modo que un compañero que esté produciendo una película al mismo tiempo consume de los mismos créditos.

Solución de problemas

  • Comando no encontrado. El directorio en el que npm instala los binarios globales no está en tu PATH. Añádelo y abre una nueva terminal.
  • No autorizado. El token almacenado se eliminó o se borró el archivo de configuración. Vuelve a ejecutar yesilcam login.
  • El servidor MCP no aparece. El nombre de la variable de entorno es YESILCAM_TOKEN y su valor es el token de yesilcam login --json, no tu contraseña. Reinicia el cliente después de añadir el servidor.
  • Un trabajo no devuelve ningún resultado. Consulta su estado; un trabajo fallido se reembolsa y puede volver a enviarse.

Preguntas frecuentes

¿La CLI tiene un coste adicional? No. Utiliza el mismo monedero de créditos y los mismos precios que la aplicación.

¿Dónde se almacena el token? En ~/.config/yesilcam/config.json, legible solo por tu usuario. yesilcam logout lo elimina.

¿Puede Claude gastar créditos sin preguntar? Solo si se lo permites. Cada herramienta informa del trabajo y de su estado, la herramienta de precios te permite presupuestar primero, y se respeta la instrucción de preguntar antes de usar niveles superiores a Draft.

¿Puedo usar la CLI y la aplicación al mismo tiempo? Sí. Los trabajos de ambas aparecen en la misma cola y en la misma Biblioteca.