Dar acceso a un servicio de pago a un asistente de IA o a un script plantea dos preguntas razonables: ¿qué le impide gastar sin preguntar?, y ¿qué pasa si la clave se filtra? El CLI y el servidor MCP de Yeşilçam Studios responden a ambas con el mismo diseño. Toda operación que gasta tokens devuelve primero un precio y no cobra nada, y toda clave API tiene límites en lo que puede hacer. Esta guía explica las dos cosas para que decidas cuánta libertad das a tu asistente. La instalación está en la guía de configuración.

¿Por qué cada herramienta de pago devuelve antes un presupuesto?

Las herramientas que gastan tokens nunca cobran en la primera llamada. Devuelven un presupuesto marcado como quote_only_nothing_charged, con el desglose, el total, tu saldo actual y si te alcanza. El asistente tiene instrucciones de enseñarte ese precio y preguntarte. Solo cuando dices que sí vuelve a llamar a la misma herramienta con confirm=true, y solo entonces empieza el trabajo y se descuentan los tokens.

En la práctica, la conversación va así: pides una imagen en borrador, el asistente te contesta con el precio y tu saldo, dices que sí y genera la imagen. Si dices que no, no se ha gastado nada.

Los usos gratuitos mensuales incluidos en un plan de pago aparecen con 0 tokens en el presupuesto y aun así piden aprobación, porque consumen parte de tu cupo.

¿Cómo funcionan las aprobaciones en la terminal?

Si ejecutas un comando de pago sin opciones extra, el CLI muestra el presupuesto y pregunta Spend about … tokens? [y/N]. Responde y para continuar. Para scripts tienes tres opciones:

  • --yes aprueba el precio presupuestado sin preguntar.
  • --max-tokens <n> rechaza el trabajo si el presupuesto supera n, incluso con --yes. Úsalo como límite de seguridad en todos tus scripts.
  • --quote solo muestra el precio y termina.

Cuando no hay una terminal interactiva, o cuando usas --json, un comando de pago sin --yes muestra el presupuesto, no cobra nada y termina con el código 3. Así un script puede distinguir «presupuesto mostrado, sin aprobar» de un trabajo terminado. El código de salida 2 significa que no has iniciado sesión.

yesilcam video create "ocean waves at sunset" --tier draft --duration 5 --quote
yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --aspect 16:9 --max-tokens 50000 --yes --out lighthouse.png

El asistente tiene el mismo límite: pídele que no pase de cierto número de tokens y enviará max_tokens, con lo que la herramienta rechazará cualquier cosa más cara.

¿Cómo son los precios y los reembolsos?

Los precios son los mismos que en la app, con tu plan aplicado, y los trabajos que fallan se reembolsan automáticamente. yesilcam account pricing lista el precio en tokens de cada operación y yesilcam account price da el precio exacto de una operación para tu plan. Dos funciones tienen sus propias reglas de gasto:

  • Los vídeos largos se cobran capítulo a capítulo mientras se producen. Si te quedas sin tokens, la producción se pausa y la retomas con longvideo resume.
  • Las automatizaciones se guardan con un tope mensual. Al aprobar una automatización autorizas el gasto hasta ese tope, y nunca lo supera.

¿Solo lectura o Lectura y creación?

Al crear una clave en Cuenta → Desarrollador eliges su acceso. Una clave de Solo lectura puede ver tu cuenta, tu saldo, los precios, tu biblioteca y el estado de tus trabajos, y descargar resultados. No puede crear, editar, borrar ni gastar nada. Una clave de Lectura y creación puede además iniciar trabajos y gastar tokens, siempre pasando por el presupuesto y la aprobación.

El servidor MCP tiene un interruptor aparte: si lo inicias con --read-only, solo carga herramientas de lectura aunque la clave pudiera hacer más. Usa una clave de solo lectura para scripts de informes y paneles, y una clave de creación solo donde de verdad haya que producir algo.

¿Qué no puede hacer nunca una clave API?

Algunas acciones se quedan en la app web, sea cual sea el acceso de la clave:

  • borrar la cuenta o cambiar su contraseña o su correo;
  • pagar, comprar tokens o planes, o activar las recargas automáticas de las automatizaciones;
  • crear o revocar claves API;
  • conectar cuentas de redes sociales.

Así, una clave filtrada como mucho puede gastar los tokens que ya tienes en tu saldo, y siempre con los mismos presupuestos; no puede dejarte fuera de tu cuenta ni comprar más.

¿Cómo se guardan las claves y cómo revoco una?

En tu ordenador la clave se guarda en ~/.config/yesilcam/config.json, que solo puede leer tu usuario, y nunca se muestra en pantalla. Por nuestra parte solo guardamos una huella segura de la clave, no la clave en sí; por eso solo se muestra una vez. Cada clave puede caducar a los 30, 90 o 365 días, o no caducar nunca. Si crees que una clave se ha filtrado, revócala en Cuenta → Desarrollador y crea otra. yesilcam logout solo borra la clave de un ordenador; la clave sigue siendo válida hasta que caduque o la revoques.

¿Y la privacidad y la seguridad?

  • Tus archivos son privados. Los enlaces a tus archivos van firmados y caducan a las pocas horas; al descargar con las herramientas se renuevan. Un enlace público o una publicación en The Wall pasan por una solicitud para compartir, que puede necesitar aprobación.
  • Personas y personajes. Los personajes son siempre adultos y no se pueden usar figuras públicas reales. Tu propia foto o tu propio vídeo solo se usan con consentimiento explícito (photo_consent, video_consent) y tras una comprobación de seguridad.
  • Planes. Algunas funciones requieren Basic o Pro, por ejemplo la calidad cine, Story to Film y Flow (Pro), los vídeos de más de 30 segundos (Basic) o de más de 60 segundos (Pro) y las automatizaciones (Basic). Las herramientas te lo dicen con palabras claras.

Buenos hábitos con un asistente

  • Dile tu presupuesto al principio: «Pregúntame antes de cualquier cosa que pase de 100.000 tokens».
  • Explora en calidad borrador y produce lo que te guste en una calidad superior.
  • Pide el saldo al principio y al final de cada sesión.
  • Da a cada ordenador o servidor su propia clave, con la validez más corta que te sirva, para poder revocar una sin afectar a las demás.

Preguntas frecuentes

¿Puede el asistente aprobar un presupuesto por su cuenta? Las herramientas están pensadas para que tenga que volver a llamar con la aprobación, y el servidor le indica que te pregunte antes. Mantén siempre una respuesta tuya en ese paso para todo lo que cueste tokens, y usa una clave de solo lectura donde no deba gastarse nada.

¿Por qué un uso mensual gratuito también pide aprobación? Porque consume parte del cupo de tu plan. El presupuesto muestra 0 tokens para que sepas que no se descuenta nada de tu saldo.

¿Puede una clave comprar tokens cuando se me acaba el saldo? No. Comprar tokens o planes y las recargas automáticas solo son posibles en la app web.