fal-ai-media

Generación de Medios con fal.ai

Skill propenso a cambios. Los IDs de modelos, precios, entradas y nombres de herramientas MCP de fal.ai cambian rápidamente. Busque o recupere los metadatos actuales del modelo antes de prometer un modelo, parámetro, formato de salida o costo específico.

Genera imágenes, videos y audio utilizando modelos de fal.ai a través de MCP.

Cuándo Activar

• El usuario quiere generar imágenes a partir de descripciones de texto
• Crear videos a partir de texto o imágenes
• Generar voz, música o efectos de sonido
• Cualquier tarea de generación de medios
• El usuario dice "generar imagen", "crear video", "texto a voz", "hacer una miniatura" o similar

Requisito MCP

El servidor MCP de fal.ai debe estar configurado. Agregar a ~/.claude.json:

"fal-ai": {
  "command": "npx",
  "args": ["-y", "fal-ai-mcp-server"],
  "env": { "FAL_KEY": "TU_FAL_KEY_AQUÍ" }
}

Obtén una clave API en fal.ai.

Herramientas MCP

El MCP de fal.ai proporciona estas herramientas:

• search — Buscar modelos disponibles por palabra clave
• find — Obtener detalles y parámetros de un modelo
• generate — Ejecutar un modelo con parámetros
• result — Verificar el estado de una generación asíncrona
• status — Verificar el estado de un trabajo
• cancel — Cancelar un trabajo en ejecución
• estimate_cost — Estimar el costo de generación
• models — Listar modelos populares
• upload — Subir archivos para usar como entradas

---

Generación de Imágenes

Nano Banana 2 (Rápido)

Mejor para: iteraciones rápidas, borradores, texto a imagen, edición de imágenes.

generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "un paisaje urbano futurista al atardecer, estilo cyberpunk",
    "image_size": "landscape_16_9",
    "num_images": 1,
    "seed": 42
  }
)

Nano Banana Pro (Alta Fidelidad)

Mejor para: imágenes de producción, realismo, tipografía, descripciones detalladas.

generate(
  app_id: "fal-ai/nano-banana-pro",
  input_data: {
    "prompt": "foto profesional de producto: auriculares inalámbricos sobre superficie de mármol, iluminación de estudio",
    "image_size": "square",
    "num_images": 1,
    "guidance_scale": 7.5
  }
)

Parámetros Comunes de Imagen

Parámetro	Tipo	Opciones	Notas
prompt	cadena	obligatorio	Describe lo que deseas
image_size	cadena	square, portrait_4_3, landscape_16_9, portrait_16_9, landscape_4_3	Relación de aspecto
num_images	número	1-4	Cuántas generar
seed	número	cualquier entero	Reproducibilidad
guidance_scale	número	1-20	Qué tan cerca seguir la descripción (mayor = más literal)

Edición de Imágenes

Usa Nano Banana 2 con una imagen de entrada para inpainting, outpainting o transferencia de estilo:

# Primero sube la imagen de origen
upload(file_path: "/ruta/a/imagen.png")

# Luego genera con entrada de imagen
generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "misma escena pero en estilo acuarela",
    "image_url": "<url_subida>",
    "image_size": "landscape_16_9"
  }
)

---

Generación de Video

Seedance 1.0 Pro (ByteDance)

Mejor para: texto a video, imagen a video con alta calidad de movimiento.

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "vista aérea de dron de un lago de montaña a la hora dorada, cinematográfica",
    "duration": "5s",
    "aspect_ratio": "16:9",
    "seed": 42
  }
)

Kling Video v3 Pro

Mejor para: texto/imagen a video con generación de audio nativa.

generate(
  app_id: "fal-ai/kling-video/v3/pro",
  input_data: {
    "prompt": "olas del mar rompiendo en una costa rocosa, nubes dramáticas",
    "duration": "5s",
    "aspect_ratio": "16:9"
  }
)

Veo 3 (Google DeepMind)

Mejor para: video con sonido generado, alta calidad visual.

generate(
  app_id: "fal-ai/veo-3",
  input_data: {
    "prompt": "un bullicioso mercado callejero de Tokio de noche, letreros de neón, ruido de multitud",
    "aspect_ratio": "16:9"
  }
)

Imagen a Video

Partir de una imagen existente:

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "la cámara se aleja lentamente, el viento suave mueve los árboles",
    "image_url": "<url_imagen_subida>",
    "duration": "5s"
  }
)

Parámetros de Video

Parámetro	Tipo	Opciones	Notas
prompt	cadena	obligatorio	Describe el video
duration	cadena	"5s", "10s"	Duración del video
aspect_ratio	cadena	"16:9", "9:16", "1:1"	Relación de aspecto
seed	número	cualquier entero	Reproducibilidad
image_url	cadena	URL	Imagen de origen para imagen a video

---

Generación de Audio

CSM-1B (Voz Conversacional)

Texto a voz con calidad natural y conversacional.

generate(
  app_id: "fal-ai/csm-1b",
  input_data: {
    "text": "Hola, bienvenido a la demostración. Déjame mostrarte cómo funciona esto.",
    "speaker_id": 0
  }
)

ThinkSound (Video a Audio)

Generar audio que coincida con el contenido del video.

generate(
  app_id: "fal-ai/thinksound",
  input_data: {
    "video_url": "<url_del_video>",
    "prompt": "sonidos ambientales de bosque con pájaros cantando"
  }
)

ElevenLabs (vía API, sin MCP)

Para síntesis de voz profesional, usa ElevenLabs directamente:

import os
import requests

resp = requests.post(
    "https://api.elevenlabs.io/v1/text-to-speech/<voice_id>",
    headers={
        "xi-api-key": os.environ["ELEVENLABS_API_KEY"],
        "Content-Type": "application/json"
    },
    json={
        "text": "Tu texto aquí",
        "model_id": "eleven_turbo_v2_5",
        "voice_settings": {"stability": 0.5, "similarity_boost": 0.75}
    }
)
with open("output.mp3", "wb") as f:
    f.write(resp.content)

Audio Generativo con VideoDB

Si VideoDB está configurado, usa su audio generativo:

# Generación de voz
audio = coll.generate_voice(text="Tu narración aquí", voice="alloy")

# Generación de música
music = coll.generate_music(prompt="música electrónica optimista de fondo", duration=30)

# Efectos de sonido
sfx = coll.generate_sound_effect(prompt="trueno seguido de lluvia")

---

Estimación de Costos

Antes de generar, verifica el costo estimado:

estimate_cost(
  estimate_type: "unit_price",
  endpoints: {
    "fal-ai/nano-banana-pro": {
      "unit_quantity": 1
    }
  }
)

Descubrimiento de Modelos

Encuentra modelos para tareas específicas:

search(query: "texto a video")
find(endpoint_ids: ["fal-ai/seedance-1-0-pro"])
models()

Consejos

• Usa seed para resultados reproducibles al iterar sobre descripciones
• Comienza con modelos de menor costo (Nano Banana 2) para iterar descripciones, luego cambia a Pro para resultados finales
• Para video, mantén las descripciones descriptivas pero concisas — enfócate en movimiento y escena
• Imagen a video produce resultados más controlados que texto a video puro
• Verifica estimate_cost antes de ejecutar generaciones de video costosas

Skills Relacionados

• tasteforge-video — Destilación de sabor offline y planificación de modalidad. Sus candidatos de endpoint y manifiestos de solicitud son solo de referencia, no trabajos enviados ni flujos de Fal guardados. Una transferencia de TasteForge no autoriza carga ni generación; usa un flujo de proveedor autorizado por separado y verifica su esquema de endpoint actual antes de ejecutar.
• videodb — Procesamiento, edición y transmisión de video
• video-editing — Flujos de trabajo de edición de video con IA
• content-engine — Creación de contenido para plataformas sociales