Communitygithub.com

anuncios-ia-lab

Anúncios IA Lab — transforma un guion de anuncio en un vídeo con personajes de IA, escena por escena, con aprobación del usuario en cada paso, en tres estilos: Pixar (animación 3D), telenovela (realista, gente real con aspecto de vídeo de celular y lenguaje de telenovela) u oficina (falso documental estilo The Office, look de vídeo antiguo de los 2000, testimonios a cámara y silencios con efecto sonoro).

¿Qué es anuncios-ia-lab?

Anúncios IA Lab es un skill para agentes de IA (como Claude Code, Cursor o Codex) que automatiza la producción de vídeos publicitarios con personajes generados por IA a partir de un guion. El proceso se divide en siete etapas secuenciales: recepción del guion, creación de personajes, aprobación de personajes, división en escenas, generación de imágenes, animación de la primera escena y procesamiento en lote del resto. Cada etapa requiere la aprobación explícita del usuario antes de continuar, lo que garantiza el control creativo. El skill admite tres estilos visuales distintos: Pixar (animación 3D estilizada), telenovela (realista, con actores de aspecto real y lenguaje de telenovela) y oficina (falso documental al estilo The Office, con aspecto de vídeo antiguo y testimonios a cámara). Utiliza la API de KIE (Grok Imagine) para la generación de imágenes y vídeos, y gestiona todo el proyecto en una estructura de archivos local, incluyendo el guion, los personajes, las imágenes, los vídeos y un registro de tareas. Es especialmente útil para creadores de contenido, especialistas en marketing y cualquiera que necesite producir vídeos publicitarios atractivos de forma rápida y iterativa, manteniendo un control granular sobre cada elemento creativo.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/dankeeps/anuncios-ia-lab/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Anúncios IA Lab

Guion → personajes → escenas → imágenes → vídeo de la escena 01 → cola del resto → edición. Ninguna etapa comienza sin que el usuario apruebe la anterior. Cada etapa gasta crédito de KIE, y lo que él rechaza no debe convertirse en vídeo.

Tres estilos

EstiloCuándoReferencia (léase antes de la etapa 4)
pixar (por defecto)"creativo animado", "estilo Pixar", "animación"referencias/pixar-referencia.md
novelinha"con telenovela", "modelo telenovela", "realista", "avatar real"referencias/novelinha-referencia.md
office"estilo The Office", "falso documental", "mockumentary", "look antiguo", "testimonio a cámara"referencias/office-referencia.md

El flujo de las 7 etapas es el mismo en los tres. Cambia el aspecto (los campos de referencias/estilos/<estilo>.json, aplicados por kie.py estilo) y, en telenovela y oficina, la gramática de las escenas (etapa 4). Ante la duda sobre el estilo, pregunte junto con la etapa 3, sin bloquear la etapa 2. Los personajes de un estilo no sirven en otro: el personaje Pixar no entra en una telenovela.

Modelos de prompt: referencias/prompts.md. Léase antes de las etapas 2, 5 y 6.

Dónde está cada cosa

  • Clave: KIE_API_KEY en la variable de entorno o en el archivo .env de la carpeta de este skill (KIE_API_KEY=...). El script lo lee solo. Nunca muestre la clave en el chat. Sin clave, pida al usuario que cree una en kie.ai y la guarde en .env.
  • Script: python3 ~/.claude/skills/anuncios-ia-lab/scripts/kie.py. Usa solo la biblioteca estándar y ffmpeg; cualquier python3 a partir de 3.9 vale.
  • Proyecto: ~/Criativos animados/<AAAA-MM-DD nombre-corto>/, así:
    roteiro.md            el guion tal como lo envió
    projeto.json          personajes, escenas, prompts y lo que ya se generó (formato abajo)
    cenas.md              el texto de las escenas que aprobó
    personagens/          <id>_v1.png, <id>_v2.png… (las versiones rehechas van a antiguas/)
    imagens/cenaNN.png    primer fotograma de cada escena
    videos/cenaNN.mp4     escena animada
    tarefas.jsonl         registro de cada generación: tarea de KIE, crédito, enlace
    edicao/               montaje, subtítulo y vídeo final (scripts de edicao/)
    
  • Modelos en KIE (todos mediante POST /api/v1/jobs/createTask, luego recordInfo):
    • grok-imagine-image-2-0/text-to-image: personaje sin referencia.
    • grok-imagine-image-2-0/image-edit: escena con hasta 5 imágenes de referencia (los personajes y el entorno).
    • Vídeo, por defecto: grok-imagine-video-1-5-preview (alias grok15). Parte del primer fotograma (first_frame_url), de 1 a 15 s, en 9:16, a 720p, con audio y habla generados juntos. Cuesta 4,5 créditos/s.
    • Alternativa: google/gemini-omni-flash-1-2 (alias omni), 9 créditos/s en 720p. Solo se usa cuando el usuario lo pide o cuando el proyecto ya comenzó con él ("modelo_video": "omni" en projeto.json), para que la voz no cambie a mitad del anuncio.

Comandos del script

K="$HOME/.claude/skills/anuncios-ia-lab/scripts/kie.py"   # llamar siempre como python3 "$K" (zsh no separa $K)
python3 "$K" saldo
python3 "$K" estilo --projeto "$P" --nome pixar|novelinha|office   # crea el proyecto en el estilo
python3 "$K" lote --projeto "$P" --tipo personagens            # variaciones de cada personaje sin aprobación
python3 "$K" lote --projeto "$P" --tipo imagens                # primer fotograma de toda escena sin imagen
python3 "$K" lote --projeto "$P" --tipo imagens --cenas 03,07 --refazer
python3 "$K" lote --projeto "$P" --tipo videos --cenas 01      # etapa 6
python3 "$K" lote --projeto "$P" --tipo videos --cenas 02- --paralelo 3   # etapa 7, la cola
python3 "$K" folha --projeto "$P" --tipo personagens           # o --tipo imagens: hoja de contactos
python3 "$K" juntar --projeto "$P" --aparar                    # final.mp4 simple, sin edición
python3 "$K" status <taskId>

Las escenas que usan como referencia la imagen de otra escena del mismo lote van en una tanda siguiente, esperando que aquella esté lista.

--simular muestra lo que se enviaría, sin gastar nada. Ejecútelo una vez antes de cada lote nuevo para verificar prompts y referencias. El lote muestra el saldo antes y después e informa cuánto gastó. Repita ese número al usuario. Cuando una tarea falla, ejecutar el mismo comando de nuevo rehace solo la que faltó. El lote de vídeo tarda: ejecútelo en segundo plano (run_in_background) y espere el aviso, sin estar consultando.

Etapa 1: recibir el guion

  1. Cree el proyecto ya en el estilo correcto, con python3 "$K" estilo --projeto "$P" --nome pixar|novelinha|office. El comando crea el projeto.json a partir de referencias/modelo-projeto.json con los campos del estilo (estilo, estilo_personagem, estilo_video y regras_video). Guarde el guion tal como llegó en roteiro.md.
  2. Lea el guion y marque quién dice cada línea. Si el guion no lo dice, deduzca: el diálogo se convierte en dos personajes, el monólogo se convierte en el experto hablando a cámara. No reescriba el diálogo. El texto del guion va palabra por palabra al vídeo.
  3. Si algo es ambiguo (quién dice la línea, si la persona es el experto real), pregunte junto con la etapa 3, sin bloquear la etapa 2.

Etapa 2: crear los personajes

  1. Para cada personaje, escriba en projeto.json la ficha en portugués (descricao), el visual (una línea en inglés con pelo, rostro, ropa y colores, la misma en toda escena), el prompt en inglés y la voz (modelos en referencias/prompts.md). Defina una sola ropa para todo el anuncio, con prendas y colores exactos.
  2. Genere variacoes: 2 por personaje: lote --tipo personagens. Personaje que es persona real: su foto va en refs.
  3. Mire cada imagen con Read antes de enviarla. Una imagen con un defecto obvio (texto, manos deformadas, más de una persona, ropa diferente a la ficha) se rehace una vez antes de ir al usuario, y usted le cuenta que la rehizo.

En telenovela, el personaje es una persona fotorrealista: rostro, piel y ropa reales, sin trazo de dibujo (estilo_personagem del novelinha.json y el modelo de personaje realista en prompts.md). Si el experto real aparece, su foto va en refs, solo cuando el anuncio es de él y él autorizó el uso de la imagen. La ropa es fija dentro de cada "día" de la historia. Si el guion tiene un salto de tiempo o de lugar ("30 días después", "en la boda"), genere una segunda imagen del mismo personaje con la ropa nueva (refs = la imagen aprobada), envíela para aprobación y úsela en las escenas de ese tramo. En adelgazamiento, el "después" también cambia el cuerpo (receta en prompts.md).

En oficina, el personaje también es fotorrealista, pero la foto del elenco ya sale con el look antiguo: la persona de cuerpo entero, de pie, dentro de la oficina de los 2000 (divisoria gris, monitor de tubo, luz fluorescente), en el estilo_personagem del office.json. Así el usuario aprueba la persona y el "rollo" juntos. Ropa de oficina de la época (blusa de botones, cárdigan, pantalón de vestir, credencial sin texto). El contraste de cuerpo (quien adelgazó x quien no) sigue la receta de prompts.md.

Etapa 3: aprobación de los personajes

Envíe las imágenes con SendUserFile (todas en una llamada, con leyenda "Ana v1, Ana v2, Rafa v1…") y escriba la ficha de cada uno en 2 líneas. Pregunte qué versión se queda, o qué cambiar. Cuando él apruebe, guarde imagem (el archivo elegido) y aprovado: true en el personaje. Un ajuste se convierte en un prompt nuevo y un --refazer solo de ese personaje (--cenas <id> también filtra personajes).

Etapa 4: dividir en escenas

Una escena es un fragmento de diálogo con como máximo 8 s estimados, que se convierte en una imagen y un vídeo. Con Grok 1.5, estime 3,9 palabras/s + 0,5 s + 0,3 s por cambio de quién habla, redondeado hacia arriba, con un mínimo de 3 s. Con Omni, 3 palabras/s + 0,5 s + 0,7 s por cambio. Después de que la escena 01 salga en la etapa 6, recalibre esta cuenta con el habla real.

Lo que ya se ha visto de Grok 1.5:

  • Habla encadenada, sin pausa en el cambio de quién habla, a ~3,8 a 4 palabras/s.
  • Cuando sobra tiempo en el clip, inventa diálogo ("Sí, sigue así", "Tranquilo, te voy a ayudar"). Por eso la duración es justa, no se pide corte seco para después del final del diálogo, y las regras_video dicen que nadie habla después de la última línea entre comillas. En la revisión, toda frase transcrita que no está en el guion es motivo para rehacer la escena. El diálogo inventado solo al final del clip se elimina en la edición, que mantiene solo las palabras del guion, pero los segundos ya se pagaron.
  • Personaje en una pantalla (vídeo en el celular, TV) habla junto si el prompt no dice the video on the phone is muted. Use el campo na_tela.
  • Close-up sin rostro con cámara suelta inventa gente. En close-up de cuerpo, escriba Static locked camera, no camera movement, the head never enters the frame, nobody else appears.
  • Palabra repetida entre dos líneas seguidas desaparece. En "¿Puedo empezar hoy?" / "Hoy.", Grok corta una de las dos. El diálogo que hace eco del anterior va en un clip separado, o la escena se divide en dos.

Reglas que valen para toda escena, en los tres estilos:

  1. Siempre interacción. Los personajes se miran el uno al otro y reaccionan a lo que el otro dice. Nadie mira a cámara, excepto el experto en la llamada final ("haz clic en saber más") y, en oficina, los testimonios y las miradas fijas. Vale en la imagen y en el vídeo: escriba en el prompt hacia dónde mira cada uno (Rafa looks at Ana).
  2. Quien habla aparece hablando. En cada plano, quien está hablando está en cuadro, lo suficientemente grande para ver la boca, de frente o 3/4 hacia quien escucha, con la boca libre (nada de mano en la boca, rostro escondido en un abrazo o de espaldas). La primera línea del anuncio es el gancho: plano medio o más cerca de quien habla, nunca la persona pequeña al fondo, y habla articulada, sin atropellar.
    • El error que generó esta regla: un gancho pedido como "congelada de shock con una mano sobre la boca", en un plano abierto. La personaje habló pequeño, en la puerta, con la mano tapando la boca, y quien vio no entendió quién estaba hablando.
  3. Quién es quién, siempre explícito. Ya sucedió que el diálogo de la especialista saliera de la boca de otro personaje. Cada personaje tiene una línea visual en la ficha (pelo, rostro, ropa y colores, en inglés). La imagen de cada escena debe mostrar exactamente los personajes de la lista personagens de la escena, reconocibles por esa ficha. El prompt de vídeo dice, en cada línea, quién habla, con el visual (Carla (short curly black hair, white lab coat), warm: "..."). El script añade solo el bloque "Who is who" (nombre, visual y voz de cada uno en cuadro; quién habla fuera de cuadro; quién no habla en el clip; y que cada línea sale solo de la boca de quien está nombrado).
  4. Todo lo que la escena usa ya está en la imagen. El vídeo solo anima lo que existe en el primer fotograma. Si la persona va a apagar la cinta de correr, el panel de la cinta está en la imagen. Si va a abrir la nevera, la nevera está allí. Si va a espiar por encima de la divisoria y agacharse detrás de ella, la divisoria está entera delante de ella, a la altura correcta. Cuando falta, Grok improvisa: la persona agarra el aire y el objeto surge a mitad del clip.
    • El error que generó esta regla: en un sketch de oficina, dos colegas "espiaban por encima de la divisoria del cubículo", pero la imagen no mostraba la divisoria delante de ellas. En el vídeo, las dos sostuvieron una divisoria invisible, y esta solo apareció cuando se agacharon.
    • Cómo aplicarlo: al escribir la escena, lea toda la acción, del primer al último segundo del clip, y enumere todo lo que alguien toca, sostiene, abre, usa, apoya, esconde detrás o pone algo encima. La lista va en la línea Elementos: del cenas.md y en el campo elementos (en inglés) del projeto.json.
    • El script escribe la lista en el prompt de la imagen ("ya está entero en el primer fotograma, en el lugar y el tamaño correctos") y en el del vídeo ("solo mueve lo que está visible; nada aparece ni desaparece; nadie finge sostener algo invisible"). Las regras_video de los tres estilos también traen esta limitación.
    • En la revisión de la imagen, cada elemento es un elemento de la lista: si falta, está cortado por el borde o en el lugar equivocado, rehaga antes de animar.
  5. Congruencia de escenario. Cada lugar tiene un escenario fijo, y no cambia cuando la cámara cambia de un personaje a otro. En el plano y contraplano, el fondo de cada uno es el otro lado de la misma habitación: la ventana sigue en el mismo lado, los armarios en el mismo lugar, la misma luz y la misma hora del día. Lo que alguien cogió sigue en su mano en la escena siguiente, el plato no cambia de lugar y la taza no desaparece.
    • Cómo aplicarlo: describa cada lugar una vez en ambientes (en inglés, con la disposición: lo que está a la izquierda, a la derecha y al fondo) y marque en cada escena el ambiente. El script repite la misma descripción en toda escena de ese lugar. La escena que abre el lugar se genera primero y va en refs de las otras.
    • Quien está de pie o sentado continúa así hasta que la escena muestre a la persona cambiando.
    • En la revisión, compare cada imagen con la anterior del mismo lugar: pared, muebles, lado de la ventana, luz, objetos y postura.

Reglas de dinamismo de Pixar (la referencia cambia de plano cada ~2 s):

  • No repita el encuadre de la escena anterior. Alterne dos en cuadro, por encima del hombro, close-up de reacción, experto solo hablando a cámara e ilustración.
  • Una escena de 6 a 8 s lleva 2 o 3 planos dentro de ella (por ejemplo, dos en cuadro y luego un corte seco al close-up de la reacción de quien escucha). Escena de 3 a 4 s lleva un solo plano.
  • Lo que se dice se convierte en imagen. Parte del cuerpo, número, comparación, "vídeo en TikTok", "clase grabada": ilústrelo de forma literal y exagerada (metabolismo con un candado, barriga ardiendo como brasa, alma saliendo del cuerpo, mano sosteniendo el celular con la escena en la pantalla). Una escena así puede durar 3 s.
  • Reacciones exageradas de Pixar en quien escucha: shock, rabia, duda, risa.
  • Cambie el entorno en el giro del argumento (del problema al mecanismo, del mecanismo a la oferta).
  • Llamada final: el experto solo, mirando a cámara, señalando hacia abajo. Cierre con los dos juntos reaccionando.

En telenovela, la gramática es otra (detalles en novelinha-referencia.md):

  • Una persona

…

[truncado para la traducción]

Skills relacionados