Bria FIBO 2.0 文生图与图生图：参数、提示词与调用示例

Bria FIBO 2.0 的两个模型入口

Bria FIBO 2.0 在平台上提供两个模型：Bria FIBO 2.0 文生图（fibo-2.0/text-to-image）从一段提示词生成图像，Bria FIBO 2.0 图生图（fibo-2.0/image-to-image）在已有图像上按自然语言指令做编辑。两者定价一致，都是每张 $0.0572；输出约 100 万像素，1:1 比例时为 1024×1024。

Bria 使用授权数据训练模型，适合商用场景。它对机位、光线、景深、构图这类摄影要素的控制比较强，这也是使用它时最值得利用的地方：与其堆形容词，不如把这些要素写成明确的、可逐段调整的描述。

适合交给它的三类工作

• 已有素材的机位与光线调整：手上有一张拍好的商品图或人像，只想把视角换成 45 度俯拍、把光线从正午改成黄昏，人物姿势、服装、背景都不要动。图生图擅长只改一个属性而其余保持不变，这类需求正对口。
• 指定风格的场景概念图：用结构化描述写清场景、机位与光线，再从 Kodak Film、Hard Flash、Hazy Dreamy、Rough Realism 里选一个风格，用于早期的视觉方向探索。
• 带蒙版的局部替换：只改画面中的某一块区域，例如替换桌面上的摆件或换掉背景里的一块招牌，用黑白蒙版圈定范围，其余部分保持原样。

参数怎么用

两个模型的入参结构不同：文生图的核心字段是 prompt，图生图的核心字段是 instruction。字段名相近，取值与约束却有差别，分开看更稳妥。

Bria FIBO 2.0 文生图（fibo-2.0/text-to-image）

aspect_ratio 的 21 种取值包括 1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、16:10、10:16、2:1、1:2、21:9、9:21、3:1、1:3、4:1、1:4、5:1、1:5。不传时按 1:1 出图。输出总量约 100 万像素，比例只改变长宽分配。

style 与 image_url 不能共存，这一点要在代码里做前置校验：需要固定风格时传 style，需要参考某张图的视觉特征时传 image_url，两者只能选一个。参数冲突不会在出图侧自动消解，提前拦截比事后排查省事。

Bria FIBO 2.0 图生图（fibo-2.0/image-to-image）

image_urls 的顺序有意义：第一张决定被编辑的主体，其余几张只在 instruction 中被引用时才起作用，引用方式是在 instruction 里写 <image_1>、<image_2>。参考图不写进 instruction，就等于没有用到。

不传 aspect_ratio 时跟随第一张图；单图编辑始终保持原图比例。mask_url 只在需要限定改动范围时使用：蒙版是黑白图，白色表示要改的区域，尺寸必须与原图一致才能对齐；带蒙版时 image_urls 只能提交 1 张，无法再附加参考图。

使用图生图时，指令最好只针对一个属性。机位、光线、时间、服装、材质任选其一，其余描述写成「保持不变」，结果更容易判断是否达标。

提示词怎么写

推荐的描述顺序是：主体与动作 → 场景 → 机位视角 → 光线时段 → 景深焦点 → 材质画质。按这六段写，等于把画面拆成六个可独立调整的变量：想换机位只改第三段，想换时间段只改第四段，其余描述原封不动，改动带来的差异就能被清楚归因。对摄影要素的控制是这个模型的长项，这六段基本覆盖了它的强项范围。

示例一：文生图的 prompt

一个穿深灰羊毛大衣的女性站在雨后的街角，正把一把黑色长柄伞收拢。
街道两侧是清晨尚未开门的店铺，卷帘门半掩，地面有积水。
35mm 视角，略低机位，从人物左前方拍摄，人物位于画面右侧三分线。
阴天清晨的散射光，色温偏冷，没有直射阳光。
f/2 浅景深，人物面部清晰，背景建筑逐渐虚化。
羊毛面料可见细密纹理，金属伞骨有轻微高光，整体颗粒细腻。

提交时再指定 style 为 Kodak Film、aspect_ratio 为 3:2、seed 为 5555。六段描述各自独立，后续想换成 Hard Flash 的硬光风格，只需改 style 与光线段，其余五行保持原样即可对比差异。

示例二：图生图的 instruction

把 <image_1> 的机位改为从正上方俯拍，保持人物的姿势、服装和所处位置不变。
<image_2> 作为服装材质参考，大衣的织物纹理与光泽按 <image_2> 处理。

这里 image_urls 传两张：第一张是待编辑的原图，第二张是材质参考图，因此 instruction 里必须用 <image_1>、<image_2> 明确指代。指令本身只做两件事——改机位、按参考图处理材质——这正是图生图擅长的范围：一次只改一个属性，其余部分尽量不动。把改动控制在单一维度，既能减少返工，也便于判断这次调用是否达到预期。

价格与内容安全

两个模型都是每张 $0.0572，计费规则与比例、风格、参考图张数、是否带蒙版全都无关。1:1 和 21:9 同价，传 4 张图和传 1 张同价，带 mask 和不带 mask 同价。费用只由出图张数决定：100 张是 $5.72，1000 张是 $57.2。

内容安全上有一点必须提前知道：如果描述里出现不合规内容，接口不会返回错误，模型会把提示词改写成安全内容后继续出图。改写后的画面可能与你原本的意图无关，但这次调用照常计费。所以提示词要在提交前自查，尤其是涉及人物、服装、场景的敏感描述——出问题不会是报错，而是一张不相关的图和一笔费用。

API 调用示例

两个模型都走异步任务接口：先 POST /v1/tasks 提交任务，从响应里拿到任务 id，再轮询 GET /v1/tasks/{id} 取图片地址。

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/text-to-image",
    "input": {
      "prompt": "一个穿深灰羊毛大衣的女性站在雨后的街角，35mm 视角，略低机位，阴天清晨的散射光，f/2 浅景深，羊毛面料可见细密纹理。",
      "style": "Kodak Film",
      "aspect_ratio": "3:2",
      "seed": 5555
    }
  }'

curl "$HIAPI_BASE_URL/v1/tasks/{id}" \
  -H "Authorization: Bearer $HIAPI_API_KEY"

图生图沿用同一个任务接口，只换 model 与 input：

curl -X POST "$HIAPI_BASE_URL/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fibo-2.0/image-to-image",
    "input": {
      "instruction": "把 <image_1> 的机位改为从正上方俯拍，保持人物姿势与服装不变。<image_2> 作为服装材质参考。",
      "image_urls": [
        "https://example.com/scene.jpg",
        "https://example.com/fabric.jpg"
      ],
      "seed": 5555
    }
  }'

常见问题

style 和 image_url 能一起传吗？

不能。两者互斥，同时传会冲突。需要指定风格时用 style，需要参考某张图的视觉特征时用 image_url，二选一。

传了 mask_url 之后，image_urls 还能传多张吗？

不能。带蒙版时 image_urls 只能是 1 张，也就是被编辑的那张图；蒙版本身是黑白图，白色区域表示要改的部分，尺寸必须与原图一致。

想复现同一张图该怎么做？

固定 seed。取值范围是 0–2147483647，默认 5555；相同 seed 加相同提示词可以复现结果。图生图的 seed 默认值同样是 5555。