video-generator — Video Multinube (Higgsfield)
Genera clips de video a través de Higgsfield — una plataforma que agrupa más de 6 modelos líderes bajo una única API y cuenta de facturación. Elige el modelo adecuado según la relación costo vs. calidad; el resto de la interfaz es idéntica.
El directorio de la skill (donde reside este SKILL.md) se denomina $SKILL_DIR más abajo.
Basado en la nube. No se requiere GPU local. Requiere una cuenta de Higgsfield y una clave API de cloud.higgsfield.ai.
Modos
| Modo | Disparador | Qué sucede |
|---|---|---|
text-to-video | Sin imágenes en input/ | Genera video solo a partir del prompt |
image-to-video | Imágenes presentes en input/ | Anima cada imagen en un clip |
auto (por defecto) | — | Elige automáticamente el modo anterior |
Preajustes
La skill utiliza preajustes como capas finas sobre el mismo motor de video. Un preajuste puede establecer el modelo por defecto, la relación de aspecto, la duración y un prefijo de prompt. Los valores de configuración explícitos siempre tienen prioridad.
| Preajuste | Mejor para | Modelo por defecto | Relación por defecto |
|---|---|---|---|
cinematic (por defecto) | Video cinematográfico de uso general | kling | 16:9 |
social-hook | Formato corto que detiene el desplazamiento | seedance | 9:16 |
motion-design-ad | Anuncios de movimiento SaaS/producto | kling | 16:9 |
ecommerce-ad | Clips promocionales de productos | kling | 9:16 |
brand-story | Narrativa de fundador/marca | kling | 16:9 |
product-360 | Exhibición de producto aislado | kling | 1:1 |
Reglas del flujo de trabajo:
- elige un preajuste antes de editar
config.json - verifica que el preajuste coincida con el estilo de salida deseado
- si el usuario no elige, mantén el preajuste por defecto y regístralo en la configuración
- no apiles el mismo estilo dos veces; si el prompt ya coincide con el preajuste, mantén el prompt tal cual
Modelos
| Clave | ID del modelo completo | Mejor para |
|---|---|---|
kling (por defecto) | kling-video/v2.1/pro/image-to-video | Movimiento realista, rentable |
seedance | bytedance/seedance/v1/pro/image-to-video | Sincronización de audio nativa |
dop | higgsfield-ai/dop/standard | Física óptica de Cinema Studio |
dop-preview | higgsfield-ai/dop/preview | Cinema Studio (nivel de vista previa) |
Estos son los IDs de modelo confirmados en la documentación oficial. Modelos adicionales (Sora, Veo, Wan, etc.) se pueden encontrar en cloud.higgsfield.ai/explore. Para agregar uno, insértalo en
MODEL_IDSengenerate.pyy agrega un alias--model.Los créditos se facturan solo por generaciones exitosas; las solicitudes fallidas y NSFW se reembolsan.
Configuración (solo la primera vez)
cd "$SKILL_DIR" && uv sync
Obtén las credenciales de cloud.higgsfield.ai (Clave API + Secreto API), luego expórtalas usando una de estas formas:
# Opción A — combinada (recomendada)
export HF_KEY="tu-api-key:tu-api-secret"
# Opción B — variables separadas
export HF_API_KEY="tu-api-key"
export HF_API_SECRET="tu-api-secret"
Flujo de Trabajo del Agente
1. Pregunta al usuario
Antes de generar el video, necesito saber:
🎬 Modo
- text-to-video (solo prompt) o image-to-video (coloca imágenes en input/)
- por defecto: detección automática
🎛️ Preajuste (por defecto: cinematic)
- cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360
- verifica la elección antes de escribir config.json
- si se omite, mantén el preajuste por defecto y registra esa elección
🤖 Modelo (por defecto: kling)
kling · seedance · dop · dop-preview
Recomendación: kling para velocidad/costo, seedance para calidad
💬 Prompt (requerido)
Describe el movimiento o la escena, por ejemplo:
"acercamiento cinematográfico lento, luz cálida de la hora dorada, deriva sutil de la cámara"
⚙️ Configuración
- duration — duración del video en segundos (por defecto: 6, rango: 3–16)
- aspect_ratio — 16:9 · 9:16 · 1:1 (por defecto: 16:9)
- resolution — 720p · 1080p (por defecto: 1080p)
Espera la respuesta del usuario antes de continuar.
2. Edita config.json
Escribe o actualiza $SKILL_DIR/config.json según las elecciones del usuario.
Establece preset explícitamente, incluso cuando uses el valor por defecto.
3. (solo image-to-video) Coloca las imágenes
Copia las imágenes de origen en $SKILL_DIR/input/. Formatos compatibles: .jpg .jpeg .png .webp
4. Ejecuta
cd "$SKILL_DIR" && uv run python scripts/generate.py --config config.json
5. Reporta los resultados
Informa al usuario:
- Ruta(s) del archivo de salida en
output/ - Modelo utilizado y costo aproximado en créditos
- Duración del video y resolución
Referencia de Configuración
| Clave | Valores | Por defecto | Descripción |
|---|---|---|---|
input_dir | ruta | ./input | Imágenes de origen (solo image-to-video) |
output_dir | ruta | ./output | Donde se escriben los MP4 |
mode | auto · text-to-video · image-to-video | auto | Modo de generación |
preset | cinematic · social-hook · motion-design-ad · ecommerce-ad · brand-story · product-360 | cinematic | Capa de preajuste creativo |
model | kling · seedance · dop · dop-preview | kling | Qué modelo usar |
prompt | cadena | (requerido) | Descripción del movimiento o escena |
duration | entero 3–16 | 5 | Duración del video en segundos |
aspect_ratio | 16:9 · 9:16 · 1:1 | 16:9 | Relación de aspecto de salida |
extra_params | objeto | {} | Parámetros de paso directo a la API del modelo |
Invocaciones Comunes
# Texto a video con el modelo por defecto (kling)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "toma con dron sobre montañas brumosas al amanecer" --duration 8
# Imagen a video con Kling (coloca las imágenes en input/ primero)
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "acercamiento cinematográfico lento, luz de la hora dorada" --model kling
# Mayor calidad: Seedance
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "alejamiento aéreo sobre una ciudad nublada al amanecer" --model seedance
# Video vertical para Reels/TikTok
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "persona hablando, fondo con bokeh natural" \
--aspect-ratio 9:16 --model kling
# Borrador rápido: menor resolución, clip más corto
cd "$SKILL_DIR" && uv run python scripts/generate.py \
--prompt "presentación de producto sobre fondo oscuro" \
--resolution 720p --duration 4 --model dop-preview
Salida
Cada trabajo escribe un .mp4 en output_dir:
- texto a video:
output.mp4 - imagen a video:
<nombre_imagen>.mp4por imagen de entrada
vs animate-image
animate-image | video-generator | |
|---|---|---|
| Proveedor | fal.ai | Higgsfield |
| Modo | solo imagen→video | texto→video + imagen→video |
| Modelo | LTX-2.3 Fast (fijo) | Kling, Sora, Veo, Wan, Seedance, MiniMax |
| Velocidad | Muy rápida | Depende del modelo |
| Resolución máxima | 4K | 1080p |
| Controles cinematográficos | No | Mediante extra_params |
Usa animate-image para clips rápidos, económicos y de alta resolución a partir de imágenes.
Usa video-generator cuando necesites texto a video, elección de modelo o los controles
físicos de Cinema Studio de Higgsfield.
Notas de la API
La skill se comunica directamente con la API REST de Higgsfield (cloud.higgsfield.ai).
Las rutas de los endpoints de los modelos se definen en MODEL_ENDPOINTS al inicio de generate.py.
Si Higgsfield actualiza una ruta, anúlala mediante la configuración "extra_params" o actualiza la
constante — no se necesitan otros cambios.