用途
edit-image 用于对图像进行编辑、修改、变换等操作。当用户提出编辑、修改、改变、转换图片等需求时使用该技能。它通过 fal.ai 的图像编辑接口完成处理，默认使用 GPT-Image 2 模型。
主要能力
- 通过提示词（--prompt）描述编辑指令，长度支持 2–32k 字符。
- 支持一张或多张源图（--image，可重复），来源可以是本地文件路径或 URL。
- 支持选择模型（--model）：gpt-2（默认）与 gpt。
- 支持蒙版编辑（--mask，仅 --model gpt）。
- 支持指定输出尺寸（--size）：auto、1024x1024、1536x1024、1024x1536、1:1、16:9、9:16、4:3、3:4、21:9。
- 支持质量（--quality）：low、medium、high，默认 medium。
- 支持保真度（--fidelity）：low、high，默认 high，控制对源图的遵循程度（仅 --model gpt）。
- 支持生成数量（--num-images）：1–4，默认 1。
- 支持输出格式（--format）：jpeg、png、webp，默认 png。
- 支持背景（--background）：auto、transparent、opaque，默认 auto（仅 --model gpt）。
- 支持指定输出文件名（--filename）或输出路径（--output），以及输出目录（--output-dir，默认操作系统临时目录）。
模型选择
- gpt-2：对应端点 openai/gpt-image-2/edit，为默认模型，是当前 OpenAI 图像模型。
- gpt：对应端点 fal-ai/gpt-image-1.5/edit，适用于透明背景、基于蒙版的编辑或保真度控制。
仅当用户需要透明背景、蒙版或保真度控制时才自动选择 gpt，否则保持默认的 gpt-2。
使用方式
通过 uv run 运行内置的 Python 脚本：
uv run ./scripts/edit.py --prompt "PROMPT" --image <path-or-url> [OPTIONS]
脚本会从 fnox 内部加载 FAL_KEY，并自动将本地文件上传到 fal CDN。
工作流程：
- 确定源图——用户可能提供路径，或引用最近生成/保存的图片。
- 解析编辑提示词及可选参数。
- 默认使用 gpt-2；仅在需要透明、蒙版或保真度控制时切换到 gpt。
- 运行脚本——它会上传本地文件、调用 API，并将保存的文件路径打印到标准输出。
- 使用 Read 工具向用户展示每张保存的图片。
- 告知用户文件保存位置。
适用场景
适用于需要对已有图片进行编辑、修改、变换、转换等操作的场景，支持本地文件与远程 URL 作为输入，可控制尺寸、质量、格式、数量、背景与保真度等参数。
限制
- 蒙版（--mask）、保真度（--fidelity）与背景（--background）选项仅在 --model gpt 下可用。
- 提示词长度需在 2–32k 字符之间。
- 生成数量限制为 1–4 张。
- 需要 FAL_KEY（由脚本从 fnox 内部加载）。
- 关于收费、价格、平台支持范围等信息，资料暂未提供。