用途:构建并运行 Bria FIBO 与 FIBO Lite 的图像生成工作流,覆盖文生图、单张参考图启发、结构化提示词保存与复用,以及基于结构化提示词加种子的复现。默认使用 Bria 一方托管的 v2 API,除非用户明确要求本地权重;本地权重授权与托管 API 条款需分开处理,不得把一方请求经 fal.ai、Replicate 等网关转发。
主要能力:提供四条路由——POST /image/generate(Standard,文档称经 Gemini 2.5 Flash 桥接后走完整 FIBO,支持 resolution、negative_prompt、steps_num)、POST /image/generate/lite(Lite,文档称经开源 FIBO-VLM 桥接,当前 schema 无上述三个字段)、POST /structured_prompt/generate 与 POST /structured_prompt/generate/lite(仅产出结构化提示词,无图像输出)。基础地址为 https://engine.prod.bria-api.com/v2,认证用 api_token 请求头,并建议发送 User-Agent: BriaPlatform/APIdocs/LLMsAgent。图像生成请求需在 prompt、images(至多一张)、images+prompt、structured_prompt、structured_prompt+prompt 中互斥选择;结构化提示词路由不允许单独 structured_prompt。常用字段含 model_version(当前枚举仅 FIBO)、aspect_ratio、seed、sync(默认 false)、webhook_url、output_type、ip_signal 及三项内容审核开关(默认 true)。
使用方式:先写决策记录,明确意图、交付方式、输入、输出、治理与花费;生产环境用异步并轮询或 webhook。迭代时保存返回的 structured_prompt 与 seed,每次只做一处隔离修改。任何托管生成或结构化提示词提交都会消耗配额并可能计费,需先满足 SEND_BRIA_REQUEST=1、APPROVE_BRIA_PAID_CALL=YES、数值 BRIA_MAX_COST_USD 及与干跑绑定的 BRIA_APPROVED_REQUEST_SHA256。
适用场景与限制:适合需要权利意识、可审计提示词与可复现迭代的图像生产。Standard 定位最高解释质量,Lite 定位速度与低成本但存在质量取舍,应先用自有提示词集基准测试。Standard 文档称 Gemini 2.5 Flash 参与提示词/图像转 JSON,公开页面未明确托管数据路径、子处理方、区域与保留策略,敏感、受监管、个人或机密输入在合同/DPA 明确前不要发送。公开价格页(2026-07-10)列出 Fibo $0.03/图、Fibo Lite $0.02/图、Fibo Structured Prompt $0.02/次,Business 与 Enterprise 定制,并宣传 100 次免费生成;税费、失败任务计费、4MP 处理与 Lite 结构化提示词定价未完全明确。公开速率限制存在冲突(10/60/1000 与 10/60/150 每分钟),不要硬编码,应读取响应头、遵守 429 并确认账户实际限额。资料未提供本地部署细节、具体字节/像素上限与确定性保证,相关数值仅为客户端启发式。