使用说明
核心用法\n\nBria AI 是一套面向电商与创意设计的 AI 图像生成与编辑工具，通过 MIT 协议开源。其核心能力围绕**可控生成**展开——不同于黑箱式生成器，用户可通过文本指令、区域遮罩、坐标定位等方式精确控制图像输出。主要功能模块包括：\n\n- **FIBO 生成**：从文本生成高质量图像，支持 1MP/4MP 分辨率及多种宽高比\n- **FIBO-Edit**：无需遮罩的文本指令编辑（如"将杯子改为红色"）\n- **GenFill/区域编辑**：基于遮罩的精确修复、添加或替换局部内容\n- **RMBG-2.0**：背景移除，输出透明 PNG\n- **产品摄影专用**：Lifestyle Shot 将透明产品图嵌入场景，Product Integrate 支持多产品精确坐标合成\n- **图像增强**：超分辨率（2x/4x）、画质增强、风格迁移、季节/光照调整、老照片修复等\n\nAPI 采用标准 REST 设计，支持同步（single image）与异步+轮询（batch）两种模式，要求 `api_token` 和 `User-Agent` 头认证。\n\n## 显著优点\n\n1. **商用安全模型**：强调训练数据合规性，降低企业法律风险\n2. **细粒度可控性**：文本指令、区域遮罩、坐标定位三级控制，适合需要精确对齐的电商场景\n3. **电商场景深度优化**：产品合成、背景替换、Lifestyle 生成等均为原生能力，非通用模型二次适配\n4. **工作流友好**：支持批量生成、流水线编排（pipelines），提供 Python/TypeScript/Bash 多语言客户端\n5. **VGL 结构化提示**：高级用户可用 JSON 精确定义视觉属性，实现确定性生成\n\n## 潜在局限\n\n- **依赖外部 API**：所有运算云端完成，需稳定网络，无法离线使用\n- **学习曲线**：细粒度控制需要理解遮罩、坐标、VGL 等概念，非纯自然语言交互\n- **成本控制**：4MP 高分辨率、批量生成及高级功能（如 Product Integrate）可能产生显著 API 费用\n- **生成不确定性**：即使可控，AI 生成仍存在随机性，关键商用场景需人工审核\n- **生态锁定**：深度使用 VGL 等工作流后，迁移至其他平台成本较高\n\n## 适合人群\n\n- **电商运营/设计师**：快速生成产品场景图、广告 banner、主图背景替换\n- **创意团队**：需要批量生成视觉素材并纳入自动化流水线\n- **开发者**：构建 AI 图像编辑功能的 SaaS 产品，需细粒度 API 控制\n- **品牌方**：对训练数据来源有合规要求的商用图像生成需求\n\n## 常规风险\n\n- **API 密钥泄露**：`BRIA_API_KEY` 需妥善保管，硬编码或日志泄露可能导致额度盗用\n- **内容合规风险**：虽标榜商用安全，但生成内容仍需符合平台使用地法规（版权、肖像、虚假宣传等）\n- **服务质量波动**：云端 API 存在速率限制、偶发故障，生产环境需实现重试与降级策略\n- **数据隐私**：上传图片发送至 Bria 服务器，敏感图像需评估隐私政策