用途：image-edit 用于基于文本提示编辑已有的图片，即图生图变换。当需要按文字指令修改、增强或转换图片时使用；也可传入多张输入图片，用于组合风格、主体或场景。
主要能力：支持一张或多张输入（本地路径或 URL）；可用提示词描述期望的编辑效果；可指定输出宽高比、输出分辨率与输出路径；可选择服务商与模型。
使用方式：在命令行执行 npx agent-media@latest image edit --in <paths...> --prompt <text> [options]。--in 为必填，表示一个或多个输入文件路径或 URL；--prompt 为必填，是期望编辑的文本描述。可选参数包括 --aspect-ratio（如 1:1、16:9、auto）、--resolution（如 1K、2K、4K）、--out（输出路径、文件名或目录，默认 ./）、--provider（默认自动检测）、--model（模型覆盖，如 fal-ai/flux-2/edit）。多图输入时在 --in 后以空格分隔多个路径。
输出：返回 JSON 对象，包含编辑后图片路径，字段包括 ok、media_type、action、provider、output_path、mime、bytes。
服务商与限制：该操作需要外部服务商，fal 需 FAL_API_KEY，replicate 需 REPLICATE_API_TOKEN，runpod 需 RUNPOD_API_KEY，ai-gateway 需 AI_GATEWAY_API_KEY；本地服务商不支持图像编辑。其余信息暂未提供。