fal-ai-media

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# fal.ai 미디어 생성 (fal.ai Media Generation)

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

## 활성화 시점

- 사용자가 텍스트 프롬프트로 이미지를 생성하고자 할 때
- 텍스트나 이미지로부터 비디오를 제작할 때
- 음성, 음악 또는 사운드 효과를 생성할 때
- 모든 종류의 미디어 생성 작업
- 사용자가 "이미지 생성해 줘", "비디오 만들어 줘", "텍스트를 음성으로", "썸네일 만들어 줘" 또는 이와 유사한 말을 할 때

## MCP 요구 사항

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

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

API 키는 [fal.ai](https://fal.ai)에서 발급받을 수 있습니다.

## MCP 도구

fal.ai MCP는 다음 도구들을 제공합니다:
- `search` — 키워드로 사용 가능한 모델 찾기
- `find` — 모델 상세 정보 및 파라미터 가져오기
- `generate` — 파라미터와 함께 모델 실행
- `result` — 비동기 생성 상태 확인
- `status` — 작업 상태 확인
- `cancel` — 실행 중인 작업 취소
- `estimate_cost` — 생성 비용 예측
- `models` — 인기 모델 목록 보기
- `upload` — 입력으로 사용할 파일 업로드

---

## 이미지 생성 (Image Generation)

### 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 | 프롬프트를 얼마나 엄격하게 따를지 (높을수록 글자 그대로 따름) |

### 이미지 편집
인페인팅, 아웃페인팅 또는 스타일 전송을 위해 이미지 입력과 함께 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"
  }
)
```

---

## 비디오 생성 (Video Generation)

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

From kypo42/everything-claude-code-kr, MIT.

More from kypo42/everything-claude-code-kr