fal-ai-media

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# fal.ai 媒体生成

通过 MCP 使用 fal.ai 模型生成图像、视频和音频。

## 何时激活

- 用户想要从文本提示生成图像
- 从文本或图像创建视频
- 生成语音、音乐或音效
- 任何媒体生成任务
- 用户说"generate image"、"create video"、"text to speech"、"make a thumbnail"或类似内容

## MCP 要求

必须配置 fal.ai MCP 服务器。添加到 `~/.claude.json`：

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

在 [fal.ai](https://fal.ai) 获取 API 密钥。

## MCP 工具

fal.ai MCP 提供这些工具：
- `search` — 通过关键字查找可用模型
- `find` — 获取模型详细信息和参数
- `generate` — 使用参数运行模型
- `result` — 检查异步生成状态
- `status` — 检查作业状态
- `cancel` — 取消正在运行的作业
- `estimate_cost` — 估算生成成本
- `models` — 列出热门模型
- `upload` — 上传文件用作输入

---

## 图像生成

### Nano Banana 2（快速）
最适合：快速迭代、草稿、文本到图像、图像编辑。

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

### Nano Banana Pro（高保真）
最适合：生产图像、写实、排版、详细提示。

```
generate(
  model_name: "fal-ai/nano-banana-pro",
  input: {
    "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 进行 inpainting、outpainting 或风格迁移：

```
# 首先上传源图像
upload(file_path: "/path/to/image.png")

# 然后使用图像输入生成
generate(
  model_name: "fal-ai/nano-banana-2",
  input: {
    "prompt": "same scene but in watercolor style",
    "image_url": "<uploaded_url>",
    "image_size": "landscape_16_9"
  }
)
```

---

## 视频生成

### Seedance 1.0 Pro（ByteDance）
最适合：文本到视频、具有高运动质量的图像到视频。

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

From aaione/everything-claude-code-zh, MIT.

More from aaione/everything-claude-code-zh