Geração de Mídia fal.ai

Habilidade propensa a desvios. IDs de modelos, preços, entradas e nomes de ferramentas do MCP da fal.ai mudam rapidamente. Pesquise ou obtenha os metadados atuais do modelo antes de prometer um modelo, parâmetro, formato de saída ou custo específico.

Gere imagens, vídeos e áudio usando modelos fal.ai via MCP.

Quando Ativar

• O usuário quer gerar imagens a partir de prompts de texto
• Criar vídeos a partir de texto ou imagens
• Gerar fala, música ou efeitos sonoros
• Qualquer tarefa de geração de mídia
• O usuário diz "gerar imagem", "criar vídeo", "texto para fala", "fazer uma miniatura" ou similar

Requisito do MCP

O servidor MCP da fal.ai deve ser configurado. Adicione a ~/.claude.json:

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

Obtenha uma chave de API em fal.ai.

Ferramentas do MCP

O MCP da fal.ai fornece estas ferramentas:

• search — Encontre modelos disponíveis por palavra-chave
• find — Obtenha detalhes e parâmetros do modelo
• generate — Execute um modelo com parâmetros
• result — Verifique o status da geração assíncrona
• status — Verifique o status do trabalho
• cancel — Cancele um trabalho em execução
• estimate_cost — Estime o custo da geração
• models — Liste modelos populares
• upload — Faça upload de arquivos para usar como entradas

Geração de Imagem

Nano Banana 2 (Rápido)

Ideal para: iterações rápidas, rascunhos, texto para imagem, edição de imagem.

generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "a futuristic cityscape at sunset, cyberpunk style",
    "image_size": "landscape_16_9",
    "num_images": 1,
    "seed": 42
  }
)

Nano Banana Pro (Alta Fidelidade)

Ideal para: imagens de produção, realismo, tipografia, prompts detalhados.

generate(
  app_id: "fal-ai/nano-banana-pro",
  input_data: {
    "prompt": "professional product photo of wireless headphones on marble surface, studio lighting",
    "image_size": "square",
    "num_images": 1,
    "guidance_scale": 7.5
  }
)

Parâmetros Comuns de Imagem

Edição de Imagem

Use Nano Banana 2 com uma imagem de entrada para inpainting, outpainting ou transferência de estilo:

# First upload the source image
upload(file_path: "/path/to/image.png")

# Then generate with image input
generate(
  app_id: "fal-ai/nano-banana-2",
  input_data: {
    "prompt": "same scene but in watercolor style",
    "image_url": "<uploaded_url>",
    "image_size": "landscape_16_9"
  }
)

Geração de Vídeo

Seedance 1.0 Pro (ByteDance)

Ideal para: texto para vídeo, imagem para vídeo com alta qualidade de movimento.

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "a drone flyover of a mountain lake at golden hour, cinematic",
    "duration": "5s",
    "aspect_ratio": "16:9",
    "seed": 42
  }
)

Kling Video v3 Pro

Ideal para: texto/imagem para vídeo com geração de áudio nativa.

generate(
  app_id: "fal-ai/kling-video/v3/pro",
  input_data: {
    "prompt": "ocean waves crashing on a rocky coast, dramatic clouds",
    "duration": "5s",
    "aspect_ratio": "16:9"
  }
)

Veo 3 (Google DeepMind)

Ideal para: vídeo com som gerado, alta qualidade visual.

generate(
  app_id: "fal-ai/veo-3",
  input_data: {
    "prompt": "a bustling Tokyo street market at night, neon signs, crowd noise",
    "aspect_ratio": "16:9"
  }
)

Imagem para Vídeo

Comece a partir de uma imagem existente:

generate(
  app_id: "fal-ai/seedance-1-0-pro",
  input_data: {
    "prompt": "camera slowly zooms out, gentle wind moves the trees",
    "image_url": "<uploaded_image_url>",
    "duration": "5s"
  }
)

Parâmetros de Vídeo

Geração de Áudio

CSM-1B (Fala Conversacional)

Texto para fala com qualidade natural e conversacional.

…