miles990/video-gif-studio

Video GIF Studio

Entrega una animación inspeccionable, su linaje fuente y una exportación reproducible. Conserva las preferencias de movimiento, apariencia y cámara más recientes del usuario. Las imágenes de referencia son opcionales; un video existente puede ser suficiente. No heredes el personaje, pose, color, duración o restricciones de silla fundacionales de esta habilidad en trabajos no relacionados.

Ajusta el alcance solicitado

Los usuarios pueden describir solo un resultado previsto. Infiere un guion, movimiento, sincronización, cámara, efectos y salida adecuados a partir de ese objetivo; indica brevemente las opciones y procede dentro de la autorización existente. Pregunta solo por una entrada faltante necesaria, una ambigüedad relevante o nueva autorización de gasto. No exijas un cuestionario de configuración.

• Solo guion/storyboard: lee planificación, entrega el plan escrito y detente sin generar imágenes o video.
• Solo análisis de música: lee música, analiza el audio proporcionado y devuelve marcas de tiempo candidatas para cues con usos sugeridos y estado de revisión. No generes ni edites material grabado a menos que se solicite.
• Edición local simple: lee línea de tiempo y música cuando sea relevante. Prepara los fotogramas fuente antes de componer recortes, segmentos reordenados, re-temporización, pausas, bucles y una banda sonora opcional. Para sonido fuente solicitado, proporciona un source_audio alineado a la línea de tiempo y habilita --keep-audio; los fotogramas PNG solos no pueden conservar audio. La entrega de video se transmite a 30 fps por defecto; usa --platform para ajustes preestablecidos de entrega y --proxy para vistas previas (consulta entrega de video). Para efectos de postproducción solicitados explícitamente, usa scripts/fx_render.py y fx; nunca inventes efectos para acciones de personajes, sustituyas efectos por movimiento físico o escondas malas uniones.
• Generar animación/activos: continúa abajo; usa el formato solicitado, GIF por defecto, video para entregables largos/de música y PNG/hojas para uso en juegos.
• Sprites de píxeles: usa una habilidad de sprites disponible para la creación intencional de hojas de poses discretas, luego sigue el procesamiento nativo de píxeles y las pautas de exportación de esta habilidad. No exijas video continuo para cada solicitud de pixel art.

Valores predeterminados a menos que el usuario especifique lo contrario

• El movimiento sigue una física plausible y causa y efecto visibles: el soporte y la transferencia de peso impulsan el cuerpo, la mano impulsa un arma sostenida, y la tela/partículas siguen con la inercia adecuada. Los efectos nunca sustituyen la falta de movimiento físico.
• Deja que la acción produzca un desplazamiento corporal completo razonable por defecto: pasos, estocadas, avances, retrocesos y retorno al equilibrio están permitidos cuando están motivados. Muestra soporte coherente, impulso, movimiento de pelvis, aceptación de peso y recuperación. No prescribas pies fijos o una parte inferior del cuerpo inmóvil solo para simplificar la alineación o el bucle; una cámara/lienzo fijo no significa un personaje fijo. Respeta una animación en el lugar o un límite de movimiento solicitado explícitamente, reteniendo una transferencia de peso plausible dentro de ello.
• Los personajes humanos mantienen anatomía coherente, proporciones de extremidades, rangos articulares, tensión muscular y de tejido blando, perspectiva, escorzo y oclusión a lo largo del movimiento. Estos valores predeterminados también se aplican al pixel art y humanos estilizados; la exageración o el comportamiento no físico solicitado explícitamente anula el valor predeterminado relevante.
• Cuando se solicitan efectos, deja que el generador de video seleccionado los diseñe y genere junto con el movimiento, usando Grok por defecto. Respeta una alternativa seleccionada explícitamente. Al usar un fallback aceptado, retén la intención del efecto solicitado y registra la fuente de generación real. Especifica las restricciones de acción, sincronización causal, legibilidad y separación del fondo; deja las formas, colores y detalles del efecto a ese generador a menos que el usuario proporcione dirección artística. No inventes efectos para una tarea que no los solicitó. El trabajo local se limita por defecto a enmascaramiento, muestreo, temporización y codificación, no a dibujar o superponer nuevos efectos. Registra cualquier excepción solicitada por el usuario y la procedencia real del efecto.
• Mantén todo el personaje, arma y efectos visibles por defecto, incluyendo estelas, partículas en expansión y su disipación completa. Encuadra para la extensión máxima durante toda la acción, no solo la pose inicial. No recortes los efectos en el borde del lienzo ni cortes su decaimiento para ajustarlos a una exportación. Respeta la acción fuera de pantalla/recorte solicitada explícitamente; de lo contrario, trata el contenido de efecto perdido como un entregable incompleto.
• Una solicitud de bucle sin costuras sigue siendo un requisito de aceptación a través de revisiones posteriores. La reproducción repetida no es ausencia de costuras. Una vista previa con una discrepancia de límite visible está inacabada, incluso si las comprobaciones de codificación pasan.
• Para un bucle que regresa a su ubicación inicial, incluye un camino natural de recuperación y retorno. No reemplaces ese camino con re-centrado por fotograma, ajuste de posición o pies bloqueados. Preserva el desplazamiento intencional del personaje durante la exportación.

Requisitos

Para solicitudes de instalación, sigue references/install.md: haz que la IA verifique, descargue e instale los requisitos previos faltantes, incluyendo Python, en lugar de devolver una lista de verificación manual. Preserva las instalaciones funcionales; la autorización interactiva de la cuenta queda con el usuario. Usa .venv/bin/python (Windows: .venv/Scripts/python.exe) de esta carpeta de habilidad para sus scripts; no asumas que el Python del shell actual tiene las dependencias. scripts/doctor.py informa la preparación local sin consumir cuota de generación.

Usa Grok por defecto para nuevo movimiento y efectos a menos que el usuario seleccione otra ruta. Grok es una dependencia opcional, no un requisito previo para la generación de GIF. Otras herramientas de video generativas disponibles y autorizadas pueden reemplazar a Grok, o sus salidas pueden importarse. Cuando no haya una ruta de video adecuada disponible, usa una herramienta de imagen disponible para GIFs de fotogramas clave apropiados; los medios existentes también pueden procesarse localmente. Prefiere video continuo de Grok cuando esté disponible para un movimiento articulado más natural. La ruta de Grok usa Codex + Grok: Codex ejecuta esta habilidad, dirige el movimiento, usa la generación de imágenes disponible cuando sea necesario, y procesa/verifica la salida; Grok proporciona video continuo generado. Grok debe estar autenticado y tener derecho/cuota de generación de video utilizable. Esta versión incluye su propio cliente REST OAuth, usando la CLI oficial de Grok para inicio de sesión OAuth y actualización de credenciales, o una clave API directa seleccionada explícitamente, como se describe en references/grok.md. No impliques que el repositorio proporciona cuentas, suscripciones o créditos. El instalador gestiona paquetes de Python y binarios faltantes de FFmpeg/ffprobe; lee dependencias gestionadas al instalar o diagnosticar la disponibilidad de herramientas. La conversión de video/RGBA existente puede ejecutarse localmente sin una nueva llamada a Grok. Los clientes de Grok y fal.ai MiniMax H3 Max están incluidos. Cuando se seleccione fal.ai o H3 Max, lee conexión y modos fal y usa scripts/fal_video.py; nunca cambies silenciosamente de modelo o proveedor de facturación. Otros proveedores requieren herramientas disponibles o integración explícita. La generación/importación del sitio web de Grok necesita inicio de sesión en el sitio web, mientras que el cliente incluido requiere su propia sesión CLI OAuth o clave API explícita; el inicio de sesión en el sitio web por sí solo no autentica al cliente.

Selecciona la ruta

Los proveedores de generación son rutas de entrada intercambiables, no la identidad de esta habilidad. fal.ai / MiniMax H3 Max es una ruta soportada, nunca el único proveedor requerido. Aplica la misma inspección, reparación y control de calidad final a Grok, otros generadores autorizados disponibles, material grabado proporcionado por el usuario y videos locales existentes. Preserva la procedencia real del proveedor; una nueva ruta requiere su propia verificación de capacidad/autenticación y no cambia silenciosamente la autoridad de facturación.

• Video existente: inspecciónalo primero; conserva los fotogramas continuos reales cuando la acción sea utilizable. Para VFR de teléfono, rotación o HDR, usa scripts/intake.py y entrega de video antes de la preparación de fotogramas. Diagnostica antes de regenerar.
• Imágenes de referencia: míralas y asigna roles (identidad, vestuario, proporciones, pose, cámara, paleta). Registra exactamente qué referencias se envían realmente al proveedor. Una descripción textual de una foto no es una foto subida.
• Sin referencia: redacta un sujeto original y un resumen de movimiento. Cuando un personaje estable sea útil, genera una imagen de inicio usando la herramienta de generación de imágenes disponible, inspecciónala, luego anímala. La conversión directa de texto a video es una alternativa solo si el proveedor activo la soporta; no afirmes que una ruta no probada está verificada.
• Movimiento articulado natural: prefiere una fuente de video continuo sobre hojas de poses generadas independientemente. Las imágenes independientes, las transiciones cruzadas y la interpolación de flujo óptico no pueden inventar de manera fiable las trayectorias articulares faltantes.

Para arte rasterizado generado, sigue las instrucciones de la herramienta de generación de imágenes disponible; no reemplaces el arte solicitado con marcadores de posición procedimentales. Para un proveedor de video elegido, verifica sus capacidades en vivo, autenticación, entradas admitidas y exposición de precios. Lee references/grok.md para el cliente Grok incluido y sus límites. Si Grok no está disponible, tiene cuota limitada o es rechazado, lee rutas de respaldo y verifica herramientas de video alternativas autorizadas, material grabado existente, fotogramas clave generados por imagen y activos locales adecuados antes de detenerte. Informa el fallo y la ruta alternativa real; no lo ocultes detrás de una animación estática no relacionada ni cambies servicios de pago sin autorización.

Dirección y generación

Lee references/motion.md al diseñar o revisar la acción. Escribe un plan visible conciso y un mensaje ejecutable. Separa:

1. Invariantes de apariencia/cámara y roles de referencia.
2. Fases de acción ordenadas, apoyo/contacto, anticipación, desplazamiento, contacto y recuperación.
3. Duraciones aproximadas de las fases e intención de reproducción.
4. Movimiento secundario y movimiento motivado de cámara/accesorio.
5. Requisitos de fondo/iluminación y comportamiento de bucle previsto.

Usa la autorización existente del usuario; no insertes una puerta de aprobación genérica. Pregunta solo por una opción faltante relevante, nueva autorización de gasto o una entrada faltante requerida. La autorización de generación no autoriza la publicación ni mensajes a otros. Por defecto, un candidato; permite una corrección enfocada dentro del alcance autorizado, luego reevalúa desde los píxeles en lugar de reenviar ciegamente. No reintentes envíos ambiguos sin recuperar primero el ID de trabajo existente.

Preserva los archivos fuente. Guarda los mensajes, roles de entrada ordenados y hashes, modelo/configuración, ID de trabajo, estado del proveedor, duración/dimensiones reales y uso informado. Mantén los tokens de autenticación y las URL de entrega firmadas fuera de los artefactos compartidos. Una respuesta del proveedor que diga listo prueba la generación, no la anatomía correcta o el movimiento natural.

Inspecciona y refina

Para eliminación de fondo o selección de salida, lee references/transparency.md. Por defecto, Automático, preservando el movimiento fuente y los píxeles del personaje; mantén el alfa graduado en los maestros RGBA y usa APNG para animación con alfa suave, con GIF como vista previa de compatibilidad. Respeta una solicitud de formato explícita. Los usuarios pueden elegir Preservar obra de arte o Reparación/redibujado con IA; estas son opciones de flujo de trabajo, no indicadores de CLI. No redibujes automáticamente cada fotograma con GPT-Image-2.5 u otro modelo de imagen. Verifica el acceso real al modelo y la capacidad alfa, y vuelve a verificar la consistencia temporal después de cualquier reparación solicitada. Una solicitud de uso en juegos debería llevar a fotogramas PNG y un plan de activos apropiado para el motor, no una entrega solo de GIF. El scripts/sprite_export.py incluido empaqueta fotogramas RGBA uniformes en hojas de varias páginas con metadatos de temporización y pivote fijo; consulta references/sprites.md.

Para contornos sucios, fragmentos o bordes parpadeantes, lee reparación de bordes estructurales. Para salida croma o alfa limpia, usa sus comprobaciones de alfa y geometría conscientes del material: el fondo confirmado es uniforme, las superficies opacas permanecen opacas, la cobertura fraccionaria/translucidez permanece graduada, y los contornos siguen la perspectiva y el movimiento sin halos o bordes dentados. Identifica el componente real y preserva su material, iluminación y oclusión antes de elegir una reparación local; el tamaño de píxel o el desenfoque por sí solos no pueden clasificar un defecto. Un detalle que parece separado puede ser una hebra real recortada: usa recuperación guiada por fuente en una máscara revisada cuando falte la conexión, en lugar de eliminarlo automáticamente.

Para cabello saltando, bordes fraccionarios que se arrastran o cabello que se superpone a la ropa, lee reparación temporal de oclusión de cabello fino. Verifica la continuidad de la fuente, preserva las superficies de respaldo opacas y prueba tanto la recomposición fuente-fondo como los fondos contrastantes; un recorrido numérico exitoso no es una máscara correcta. No promuevas un candidato local no aceptado a una receta de toda la biblioteca.

Para agujeros no intencionales junto a correas, zapatos o espacios estrechos de extremidades, usa diagnóstico de pérdida de material opaco: distingue el sombreado del material de la silueta real, repara el RGB fuente así como el alfa cuando sea necesario, y valida las superficies positivas y los espacios negativos por separado. Nunca promuevas los parámetros de reparación de un clip a un filtro de toda la biblioteca.

Para la recuperación revisada del límite de material opaco, usa scripts/repair_material_boundary.py con contornos soportados por fuente por fotograma explícitos y máscaras de protección; consulta la herramienta de límite local. Preserva los píxeles no tocados y registra la revisión como pendiente, no aceptada. Para agujeros interiores opacos ya presentes en una máscara temprana, usa scripts/restore_opaque_material.py con máscaras opacas por fotograma revisadas y RGB fuente coincidente. Su valor predeterminado preserva el RGB recto/despill válido y recupera el color fuente solo para píxeles borrados; usa el reemplazo de fuente explícitamente para daño de color confirmado.

...

[truncado para traducción]