fal-ai-media

fal.ai 미디어 생성

MCP를 통해 fal.ai 모델을 사용하여 이미지, 비디오 및 오디오를 생성합니다.

활성화 시점

• 사용자가 텍스트 프롬프트로 이미지를 생성하고 싶어 할 때
• 텍스트나 이미지를 사용하여 비디오를 만들 때
• 음성, 음악 또는 효과음을 생성할 때
• 모든 미디어 생성 작업 시
• 사용자가 "이미지 생성해줘", "비디오 만들어줘", "텍스트를 음성으로 바꿔줘", "썸네일 만들어줘" 또는 이와 유사한 요청을 할 때

MCP 요구 사항

fal.ai MCP 서버가 구성되어 있어야 합니다. ~/.claude.json에 다음을 추가하세요:

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

API 키는 fal.ai에서 발급받을 수 있습니다.

MCP 도구

fal.ai MCP는 다음 도구들을 제공합니다:

• search — 키워드로 사용 가능한 모델 찾기
• find — 모델 상세 정보 및 파라미터 확인
• generate — 파라미터와 함께 모델 실행
• result — 비동기 생성 상태 확인
• status — 작업 상태 확인
• cancel — 실행 중인 작업 취소
• estimate_cost — 생성 비용 추정
• models — 인기 모델 목록 확인
• upload — 입력으로 사용할 파일 업로드

---

이미지 생성

Nano Banana 2 (빠름)

용도: 빠른 반복 작업, 초안 작성, 텍스트 투 이미지, 이미지 편집.

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 (고화질)

용도: 프로덕션용 이미지, 사실주의, 타이포그래피, 상세한 프롬프트.

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
  }
)

일반적인 이미지 파라미터

파라미터	타입	옵션	비고
prompt	string	필수	원하는 내용을 설명하세요
image_size	string	square, portrait_4_3, landscape_16_9, portrait_16_9, landscape_4_3	화면 비율
num_images	number	1-4	생성할 이미지 개수
seed	number	정수	재현성을 위한 시드 값
guidance_scale	number	1-20	프롬프트를 얼마나 엄격하게 따를지 (높을수록 문자 그대로 해석)

이미지 편집

인페인팅(inpainting), 아웃페인팅(outpainting) 또는 스타일 전송을 위해 입력 이미지와 함께 Nano Banana 2를 사용합니다:

# 먼저 소스 이미지를 업로드합니다
upload(file_path: "/path/to/image.png")

# 그런 다음 이미지 입력을 포함하여 생성합니다
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"
  }
)

---

비디오 생성

Seedance 1.0 Pro (ByteDance)

용도: 텍스트 투 비디오, 높은 움직임 품질을 가진 이미지 투 비디오.

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

용도: 네이티브 오디오 생성이 포함된 텍스트/이미지 투 비디오.

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)

용도: 생성된 사운드가 포함된 비디오, 높은 시각적 품질.

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"
  }
)

이미지 투 비디오

기존 이미지에서 시작합니다:

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"
  }
)

비디오 파라미터

파라미터	타입	옵션	비고
prompt	string	필수	비디오를 설명하세요
duration	string	"5s", "10s"	비디오 길이
aspect_ratio	string	"16:9", "9:16", "1:1"	프레임 비율
seed	number	정수	재현성을 위한 시드 값
image_url	string	URL	이미지 투 비디오용 소스 이미지

---

오디오 생성

CSM-1B (대화형 음성)

자연스럽고 대화하는 듯한 품질의 텍스트 투 스피치.

generate(
  app_id: "fal-ai/csm-1b",
  input_data: {
    "text": "Hello, welcome to the demo. Let me show you how this works.",
    "speaker_id": 0
  }
)

ThinkSound (비디오 투 오디오)

비디오 콘텐츠에 어울리는 오디오를 생성합니다.

generate(
  app_id: "fal-ai/thinksound",
  input_data: {
    "video_url": "<video_url>",
    "prompt": "ambient forest sounds with birds chirping"
  }
)

ElevenLabs (API를 통해 직접 사용, MCP 미사용)

전문적인 음성 합성을 위해 ElevenLabs를 직접 사용하세요:

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": "Your text here",
        "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)

VideoDB 생성형 오디오

VideoDB가 구성된 경우, 그 생성형 오디오 기능을 사용하세요:

# 음성 생성
audio = coll.generate_voice(text="Your narration here", voice="alloy")

# 음악 생성
music = coll.generate_music(prompt="upbeat electronic background music", duration=30)

# 효과음 생성
sfx = coll.generate_sound_effect(prompt="thunder crack followed by rain")

---

비용 추정

생성 전에 예상 비용을 확인하세요:

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

모델 탐색

특정 작업에 적합한 모델 찾기:

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

팁

• 프롬프트를 반복 수정할 때 재현 가능한 결과를 얻으려면 seed를 사용하세요.
• 프롬프트 테스트 시에는 저비용 모델(Nano Banana 2)로 시작하고, 최종 결과물에는 Pro 모델을 사용하세요.
• 비디오의 경우 프롬프트를 상세하면서도 간결하게 유지하고 움직임과 장면에 집중하세요.
• 이미지 투 비디오는 순수 텍스트 투 비디오보다 더 제어된 결과를 만들어냅니다.
• 비용이 많이 드는 비디오 생성을 실행하기 전에는 estimate_cost를 확인하세요.

관련 스킬

• videodb — 비디오 처리, 편집 및 스트리밍
• video-editing — AI 기반 비디오 편집 워크플로
• content-engine — 소셜 플랫폼용 콘텐츠 제작