FLUX 3 Image 现已上线 AI Gateway
内容提要
Black Forest Labs 的 FLUX 3 Image 已上线 AI Gateway，无需其账号，仅用一个 API 密钥即可文生图或改图。它支持最多十张参考图编辑、五种分辨率（768×768 至 4K）及方、竖、横三种比例。在 AI SDK 7 及以上用模型 ID bfl/flux-3-image 调用 generateImage，也可通过 AI CLI 在终端生成并保存图片。
延伸解读
接入方式与账号门槛
FLUX 3 Image 通过 AI Gateway 提供，用户无需注册 Black Forest Labs 账号，只需一个 API 密钥即可调用。这意味着开发者可以复用现有的 AI Gateway 密钥，减少多平台账号管理的麻烦。对于已经在使用 AI Gateway 其他模型的团队，迁移成本较低，只需将模型 ID 替换为 bfl/flux-3-image 即可。
编辑能力与参考图上限
该模型同时支持文生图和改图，编辑时最多可传入十张参考图，用于组合主体或调整构图。这为需要多图融合、风格迁移或局部修改的场景提供了更大的操作空间。不过，参考图数量增加也可能带来生成时间或结果可控性的变化，实际使用时建议根据任务复杂度逐步增加参考图。
分辨率与比例选项
FLUX 3 Image 提供五档分辨率，从 768×768 到 4K，并支持方形、竖版和横版三种比例。调用时可通过 providerOptions 指定 blackForestLabs.resolution，例如 '1k'。这种灵活性适合从社交媒体配图到印刷级输出的不同需求，但高分辨率通常意味着更长的生成时间和更高的计算成本，需按实际用途权衡。
开发与终端调用路径
在 AI SDK 7 及以上版本中，使用 generateImage 并传入模型 ID bfl/flux-3-image 即可生成或编辑图片。此外，也可通过 AI CLI 在终端直接生成并保存图片，命令中指定 --model 和 --output 路径。这为快速原型验证或脚本化批量处理提供了便利，但需注意 CLI 安装和 API 密钥环境变量的配置。
Q&A
FLUX 3 Image 现在可以在哪里使用？
FLUX 3 Image 现已上线 AI Gateway，无需 Black Forest Labs 账号，仅用一个 API 密钥即可使用。
FLUX 3 Image 支持哪些图像编辑功能？
它支持最多十张参考图进行编辑，可以组合主体或更改构图。
FLUX 3 Image 支持哪些分辨率和宽高比？
支持从 768×768 到 4K 的五种分辨率层级，以及方形、竖版和横版三种宽高比。
如何在 AI SDK 中调用 FLUX 3 Image 生成图片？
设置 AI_GATEWAY_API_KEY 后，在 AI SDK 7 或更高版本中使用模型 ID bfl/flux-3-image 调用 generateImage，并传入文本提示词即可。
如何用 FLUX 3 Image 编辑已有图片？
在 generateImage 的 prompt.images 中传入图片，并提供编辑指令，例如更改花瓶颜色同时保留花朵和场景。
能否在终端使用 FLUX 3 Image？
可以，使用相同的 AI Gateway API 密钥和模型 ID，通过 AI CLI 在终端生成并保存图片。
