# Flux CLI (BFL / FLUX) CLI 通过 BFL FLUX API 生成和编辑图像。 ## 快速开始 1.API密钥： * 环境： * `导出 BFL_API_KEY="..."` * 或本地保存（从标准输入读取；避免 shell 历史记录泄漏）： *`回显“$BFL_API_KEY”| Flux 配置集 apiKey` 2. 生成： *`flux gen“猫宇航员”--model Flux-2-pro --width 1024 --height 1024 -o out/` 3. 使用参考图像进行编辑： *`flux编辑“使其成为日落照明”--model Flux-2-pro --input ./in.jpg -o out/` ## 命令 `通量生成[提示]` * 文字转图像 * 提示符可以是位置提示符，或者 `-` / stdin `flux edit [提示] --input [--input ...]` * 使用提示进行图像编辑 + 1..N 输入图像（基本 + 参考） `flux fill [提示] --image [--mask ]` * 修复（显式遮罩图像，或 Alpha 通道） `flux Expand [提示] --image [--top/--bottom/--left/--right ]` * outpaint（在任意一侧按像素扩展画布） `flux 结果 [--out ]` * 通过id获取状态/结果 * 如果设置了 `status=Ready` 和 `--out`，则下载结果 `flux wait [--polling-url ] [--out ]` * 等待“就绪”/错误；可选择下载结果 `通量积分` * 显示剩余积分 `通量模型` * 列出 CLI 支持的型号密钥 `flux 配置路径|获取|设置|取消设置` * 本地配置（包括通过 stdin 保存 API 密钥） ## 全局标志 * `--json`：单个 JSON 对象到标准输出（对于脚本） * `--plain`：稳定的行输出（路径/ids） * `-q, --quiet`: 减少日志记录 * `-v, --verbose`：对 stderr 的诊断（无秘密） * `--endpoint `：API 主机（默认为 `api.bfl.ai`） * `--region `：端点快捷方式 * `--timeout `: 超时 * `--retries `：重试 429/5xx * `--out-dir `: 默认输出目录 ## 通用生成/编辑标志 * `--model `：模型键（参见`flux models`） * `--种子` * `--safety `: safety_tolerance (范围取决于型号) * `--format `: 输出格式 * `-o, --out `: 文件/目录或 stdout 的 `-` * `--no-wait`：仅提交；打印“id”（+“--json”中的“pollingUrl”） * `--poll-interval <毫秒>` 高级（逃生舱口）： * `--body `：原始请求正文（完全控制） ## 型号（按键）官方车型阵容不断演变；对当前列表使用“flux models”。内置密钥、何时使用它们以及定价等级（经验法则；定价可能会发生变化）：型号钥匙 |最适合 |定价等级 |注释 ---|---|---|--- `flux-2-klein-4b` |快速草稿；大批量生产|便宜|基于MP `flux-2-klein-9b` |更好的草稿；依然快速迭代 |便宜到平衡|基于MP `flux-2-pro` |默认选择；生产工作流程；通用生成/编辑|平衡|基于MP；编辑成本通常高于 T2I `flux-2-flex` |通过控制旋钮实现最高品质 |高级|基于MP；支持`--steps`/`--guidance`；图像编辑是 FLUX.2 中最昂贵的层 `flux-2-max` |最终资产；质量第一；接地搜索|优质/最昂贵|基于MP `flux-kontext-pro` |具有多个参考的受控编辑/变化|平衡|每次通话积分 `flux-kontext-max` |更强大的上下文编辑；质量第一|昂贵|每次通话积分 `flux-pro-1.1` | FLUX 1.1 行为；兼容性工作流程 |平衡|每次通话积分 `flux-pro-1.1-ultra` |超级模式；长宽比驱动生成；可选原始外观 |昂贵|每次通话积分 `flux-pro-1.0-fill` |修复（蒙版/阿尔法）|昂贵|每次调用的积分（工具端点） `flux-pro-1.0-expand` |外画（扩展画布）|中贵 |工具端点；检查返回的“成本”/积分 `flux-dev` |当您知道确切的 API 形状时，通过 `--body` 传递 |便宜|每次通话的积分；检查返回的“成本” `flux-pro` |当您知道确切的 API 形状时，通过 `--body` 传递 |变化 |检查返回的“成本”/积分脚注： * **基于 MP** ：成本与输出尺寸以百万像素为单位（宽度 * 高度 / 1,000,000）。较大的图像成本更高。 ## 安全/可靠性说明 * **API key** ：避免通过标志传递秘密；使用 env/config/stdin。 * **签名 URL** ：“result.sample”通常是短暂的；立即下载。 ## 编辑最佳实践（Kontext）适用于具有 Kontext 模型的“flux edit”（“flux-kontext-pro”、“flux-kontext-max”）。 ### 提示结构 * **最多 512 个代币**。明确但简洁。 * **具体**：准确的颜色名称、详细的描述、清晰的动词。 * **有意保留**：说明必须保持不变的内容。 * 不好：`“改为白天”` * 好：`“在保持画风不变的情况下改为白天”` * **直接命名主题**：使用描述性标识符，而不是代词。 * 坏：“把她变成维京人” * 好：“将女人变成维京战士，同时保留她准确的面部特征、眼睛颜色和面部表情”` * **仔细选择动词**：“变换”表示完全替换； “把衣服换成……”保持身份。 * **控制构图**：更改背景时，添加“使人物保持完全相同的位置、比例和姿势。保持相同的相机角度、取景和视角。”` ### 图像中的文本编辑 * 使用引号：`将'[原始文本]'替换为'[新文本]'` * 大小写格式很重要。 * 适用于标牌、海报、标签，无需完整图像再现。 ### 注释框输入图像上绘制的明亮彩色框充当空间参考。 * 模型会自动识别它们并将其从输出中删除。 * 对于目标文本重新定位、调整大小或指向特定区域很有用。 * 示例提示：`“在盒子里添加帽子”` ### 迭代编辑 * Kontext 擅长跨多个连续编辑的字符一致性。 * 将复杂的转换分解为步骤以便更好地控制。 * 从简单开始；在分层复杂性之前测试基本编辑。 ### 风格转移 * 命名特定风格或参考已知艺术家/艺术运动——而不是通用术语。 * 当样式名称不足时，详细说明视觉特征。 * 对于戏剧性的风格转变，请使用变革性序列（多次传递）。 * 精确的描述保留结构：“转换为具有天然石墨线、交叉影线和可见纸张纹理的铅笔草图” ### 常见陷阱问题 |原因 |修复 ---|---|--- 身份丢失|模糊的“变换”提示|使用目标动词；明确列出要保留的功能主题重新定位 |无需锚定的背景变化|添加位置/比例/框架保留条款风格漂移|无风格锚定的简单提示 |添加`“同时保持相同的风格”` 错误文字案例 |未指定情况|匹配提示中的精确大小写 ## 常见错误（退出代码） * `2`: 无效参数/验证 * `3`：缺少密钥或`403` * `4`: `402`（学分不足） * `5`: `429`（速率限制） * `6`: 适度 * `7`: 其他API/任务错误

通量

包含技能