Key en el llavero del sistema
Keychain de macOS, DPAPI de Windows o Secret Service de Linux — archivo 0600 solo como respaldo. Las variables de entorno exigen opt-in explícito. Toda la salida pasa por un redactor.
Open source · MIT · 0 dependencias en runtime
Generamedios.Conservatusllaves.
Tu agente de IA crea imágenes y video en KIE.ai — sin ver nunca la API key, y sin gastar más de lo que autorizas.
Envía este prompt a tu agente para generar medios con kie
Read https://kiecli.com/skill.md
Una guía completa: instalación, límites de gasto, modelos y códigos de salida.
Instala la CLI — Node ≥ 20, cero dependencias en runtime
$ npm i -g @uxdata-co/kie
Luego kie key set para guardar tu key, y kie skill install para tu agente.
╭─●─╮ ╱ ╲ ╱ ╱╲ ╲ ╱ ╱ ╲ ╲ ╲ ╱ ╱────╲ ╲ ╲ ╱ ╱ ╲ ╲ ●───╯ ╱ ╲ ╲ ╰───● kie v0.6.0 · media generation for AI agents images · video · zero deps · spend-guarded $ kie credits ╭─ ▲ kie credits ───────────────────────────────╮ │ balance 980 credits ≈ US$4.90 │ │ today 16 / 200 ████████████ 8% │ │ remaining today 184 credits │ ╰────────────────────────────────────────────────╯ $ kie image nano-banana-2 \ --prompt "isometric coffee shop" --aspect 16:9 ⠹ nano-banana-2 generating 40% task_c0ffee12 14s ╭─ ▲ kie generation complete ───────────────────╮ │ state success │ │ credits 8 │ │ files kie-media/nano-banana-2-c0ffee12.png │ ╰────────────────────────────────────────────────╯
Apoya este proyecto
Los mismos modelos. Hasta 84% más barato.
kie corre sobre KIE.ai — los mismos modelos Veo, Nano Banana, GPT Image, Kling y Seedance que sirven las APIs oficiales, por una fracción del precio. Billetera prepaga, sin cargos ocultos, y las generaciones fallidas nunca se cobran.
- −86% GPT Image 2 vs OpenAI
- −61% Veo 3.1 vs Google
- −50% Nano Banana 2 vs Google
- $0 por tareas fallidas
Regístrate en Kie
Al registrarte con este link de afiliado apoyas el mantenimiento y actualización de este código.
Por qué kie
Tu llave es dinero.
Las APIs de medios son las credenciales más caras de perder. La mayoría de wrappers leen la key de una variable de entorno, arrastran cientos de paquetes y traen un webhook por defecto.
Tope de gasto duro
Tope por tarea, presupuesto diario y chequeo de saldo — todo antes de que el request salga de tu máquina.
Sin terceros
Solo habla con los hosts de KIE. Sin callbacks, sin telemetría, sin proxies.
Nativo para agentes
JSON en stdout, códigos de salida para bifurcar y siempre rutas de archivo — nunca URLs que expiran.
Instalación
Dos minutos.
-
01
Instala
Node ≥ 20. Publicado con provenance de npm.
npm i -g @uxdata-co/kie -
02
Guarda la key
La entrada está oculta. No vuelve a aparecer en ninguna salida.
kie key set -
03
Instala el skill
Claude Code, Codex, Cursor y Gemini CLI.
kie skill install
Tutoriales
Solo pídelo.
Tu agente de código produce los medios, tú conservas la llave.
- 1
Sesión nueva — los skills se cargan de
~/.claude/skills/. - 2
Pide en lenguaje natural, o invoca
/kie-media.
youGenera una imagen hero 16:9 de una cafetería isométrica con luz cálida, para la landing.
Claude Code
Listo — 8 créditos. Guardada en assets/hero-coffee.png (1920×1080). ¿Quieres una versión nocturna?
$ kie credits --json$ kie image nano-banana-2 --prompt "cafetería isométrica, luz cálida" --aspect 16:9 --out ./assets --name hero-coffee --json
- 1
Sesión nueva — los skills se cargan de
~/.agents/skills/. - 2
Pide con naturalidad, o invoca
$kie-media. Para video, di el tope.
you$kie-media haz un clip de 5 segundos del barista deslizando una taza por la barra, dolly-in suave. Tope de 80 créditos.
Codex
Kling 3.0, 5 s con sonido — 64 créditos. Guardado en assets/barista-slide.mp4. Quedan 120 créditos hoy.
$ kie upload ./assets/hero-coffee.png --json$ kie video kling-3.0 --prompt "el barista desliza una taza por la barra, dolly-in suave" --image <url> --duration 5 --sound --max-credits 80 --json
- 1
Cursor 2.4+ — los skills se cargan de
~/.cursor/skills/. - 2
Escribe
/y elige kie-media, o solo pide.
you/kie-media necesito tres fotos de producto 1:1 de una taza de cerámica sobre lino, luz de día suave, para la grilla de la tienda.
Cursor
Tres imágenes, 8 créditos cada una — 24 en total. Guardadas en public/shop/mug-1.png, mug-2.png, mug-3.png.
$ kie credits --json$ kie image nano-banana-2 --prompt "taza de cerámica sobre lino, luz de día suave" --aspect 1:1 --out ./public/shop --name mug-1 --json
- 1
Inicia gemini —
/skills listmuestra kie-media. - 2
Pide con naturalidad; llama a
activate_skilly pide permiso una vez.
youHaz una imagen teaser 9:16 de una calle de mercado nocturno con letreros de neón para nuestra historia de Instagram.
Gemini CLI
nano-banana-2, 2K — 12 créditos. Guardada en assets/stories/night-market.png. Quedan 164 créditos hoy.
$ kie credits --json$ kie image nano-banana-2 --prompt "calle de mercado nocturno, letreros de neón" --aspect 9:16 --resolution 2K --out ./assets/stories --name night-market --json
- 1
Las apps de escritorio corren los shells del agente en un sandbox: sin PATH, sin llavero, sin red hacia KIE. El skill no puede correr ahí — usa el servidor MCP.
- 2
Ejecuta
kie mcp install. Registrakie mcp(stdio) en Claude Desktop, la app de Codex y Cursor con la ruta absoluta de Node. Reinicia la app. - 3
Pide con normalidad. La app lanza
kieen tu máquina; la key nunca sale del llavero y la imagen generada aparece directamente en el chat.
youGenera una imagen hero 16:9 de una cafetería isométrica con luz cálida, y luego una versión nocturna.
Claude Desktop · app de Codex
Aquí están las dos (8 créditos cada una). Guardadas en kie-media/coffee-day.png y kie-media/coffee-night.png — quedan 184 créditos hoy.
$ kie mcp install --app claude$ # la app llama: kie_credits → kie_generate_image(model: nano-banana-2, aspect: 16:9)
Lo que el agente no hará
- ✕Saltar a video — primero imágenes, luego video con
--max-credits. - ✕Subirse el tope tras un bloqueo (exit 3). Reporta la razón.
- ✕Pedir, mostrar ni configurar la API key.
- ✕Darte una URL de KIE — recibes una ruta de archivo.
kie config set dailyBudget 300
Guardia de gasto
Bloqueado es no enviado.
Tres chequeos independientes corren antes de que cualquier request salga de la máquina. Si uno falla, obtienes código de salida 3 y no se envió nada.
01
Tope por tarea
Los modelos sin precio verificado exigen un --max-credits explícito — el agente tiene que decir en voz alta cuánto acepta gastar.
02
Presupuesto diario
Un ledger local registra cada tarea y escribe los créditos reales gastados. Las pendientes cuentan por su tope.
03
Saldo
Si la estimación supera lo que queda en la cuenta, el request nunca sale.
$ kie video kling-3.0 --prompt "drone shot" ✖ Spend guard blocked the request: this model has no known credit estimate. Re-run with --max-credits <n> to state the most you accept to spend on this task. Today: 16 credits used, 184 remaining. $ echo $? 3
Documentación
Todos los comandos, una página.
Comandos y flags, catálogo de modelos, guardia de gasto y códigos de salida, configuración, el skill de agente y notas de seguridad.
Preguntas frecuentes
¿Funciona en Linux o Windows?
Sí. La key va a DPAPI de Windows (ámbito de usuario) o al Secret Service de Linux (secret-tool); sin ninguno de los dos cae a ~/.config/kie/key con permisos 0600. Todo lo demás es idéntico.
¿Cómo se construye el paquete de npm?
Cada release la publica GitHub Actions desde un tag de git, con provenance de npm: el tarball queda vinculado criptográficamente al commit que lo produjo. Cero dependencias en runtime: lo que auditas es lo que corre.
¿Y si un modelo no está en el catálogo?
kie run <model-id> --input '{…}' --max-credits N envía cualquier modelo del Market de KIE. Revisa el schema en docs.kie.ai primero, o usa --dry-run.
¿Puedo usarlo sin un agente?
Claro. En la terminal muestra tablas, paneles y un spinner en vivo; si haces pipe obtienes JSON.
IAdeimágenesbarataysegura.
Licencia MIT. Lee el código antes de confiarle una key — de eso se trata.
Ver en GitHub →