Bria FIBO 2.0 テキストtoイメージとイメージtoイメージ：パラメータ、プロンプト、呼び出し例

Bria FIBO 2.0 の 2 つのモデルエントリ

Bria FIBO 2.0 はプラットフォーム上で 2 つのモデルを提供します。Bria FIBO 2.0 テキストtoイメージ（fibo-2.0/text-to-image）はプロンプトから画像を生成し、Bria FIBO 2.0 イメージtoイメージ（fibo-2.0/image-to-image）は既存の画像に対して自然言語の指示で編集を行います。両者の価格は同じで、いずれも 1 枚 $0.0572 です。出力は約 100 万ピクセルで、1:1 の場合は 1024×1024 になります。

Bria はライセンス許諾済みのデータでモデルを学習しており、商用シーンに適しています。カメラアングル、光線、被写界深度、構図といった撮影要素の制御に比較的強く、ここが利用時に最も活かすべきポイントです。形容詞を積み重ねるよりも、これらの要素を明示的で段落ごとに調整可能な記述として書く方が効果的です。

任せるのに適した 3 種類の作業

• 既存素材のアングルと光線の調整：手元に撮影済みの商品画像や人物画像があり、視点を 45 度の俯瞰に変えたり、光線を正午から夕暮れに変えたいだけで、人物のポーズ、服装、背景は変えたくない場合。イメージtoイメージは 1 つの属性だけを変えて他を保つのが得意で、こうしたニーズにぴったりです。
• 指定スタイルのシーンコンセプト画像：構造化された記述でシーン、カメラアングル、光線を書き、Kodak Film、Hard Flash、Hazy Dreamy、Rough Realism から 1 つスタイルを選び、初期のビジュアル方向性の探索に使います。
• マスク付きの部分置換：画面内の特定の領域だけを変える場合。例えば卓上に置かれたオブジェを差し替えたり、背景の看板の一部を入れ替えたりする際に、白黒マスクで範囲を指定し、それ以外の部分はそのまま保ちます。

パラメータの使い方

2 つのモデルは入力パラメータの構造が異なります。テキストtoイメージの中核フィールドは prompt、イメージtoイメージの中核フィールドは instruction です。フィールド名は似ていますが、値の範囲や制約には違いがあるため、分けて見る方が確実です。

Bria FIBO 2.0 テキストtoイメージ（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 イメージtoイメージ（fibo-2.0/image-to-image）

image_urls の順序には意味があります。1 枚目が編集対象の主体を決め、残りの画像は instruction 内で参照された場合にのみ機能します。参照方法は instruction に <image_1>、<image_2> と書くことです。参照画像を instruction に書かなければ、使っていないのと同じです。

aspect_ratio を指定しない場合は 1 枚目の画像に従い、単一画像の編集では常に元画像の比率が保たれます。mask_url は変更範囲を限定する必要がある場合にのみ使用します。マスクは白黒画像で、白が変更する領域を表し、サイズが元画像と一致しないと位置合わせができません。マスク付きの場合、image_urls は 1 枚しか送信できず、参照画像を追加することはできません。

イメージtoイメージを使う場合、指示は 1 つの属性だけを対象にするのが最善です。カメラアングル、光線、時間、服装、素材のいずれか 1 つを選び、それ以外の記述は「変更しない」と書くと、結果が基準を満たしているか判断しやすくなります。

プロンプトの書き方

推奨される記述順は、主体と動作 → シーン → カメラアングル視点 → 光線の時間帯 → 被写界深度とフォーカス → 素材と画質です。この 6 段落で書くことは、画面を 6 つの独立して調整可能な変数に分解することに等しく、アングルを変えたいときは 3 段落目だけ、時間帯を変えたいときは 4 段落目だけを変え、他の記述はそのままにすれば、変更による差異を明確に帰属できます。撮影要素の制御はこのモデルの長所であり、この 6 段落はほぼその強みの範囲をカバーしています。

例 1：テキストtoイメージの prompt

深いグレーのウールコートを着た女性が雨上がりの街角に立ち、黒い長柄の傘を閉じようとしている。
通りの両側は早朝でまだ開いていない店舗で、シャッターは半ば下り、地面には水たまりがある。
35mm 視点、やや低いカメラアングル、人物の左前方から撮影、人物は画面右側の三分割線に位置する。
曇りの早朝の拡散光、色温度はやや寒色、直射日光はない。
f/2 の浅い被写界深度、人物の顔は鮮明で、背景の建物は徐々にぼける。
ウール生地には細かな織り目が見え、金属の傘骨にはわずかなハイライトがあり、全体の粒子は繊細。

送信時に style を Kodak Film、aspect_ratio を 3:2、seed を 5555 に指定します。6 段落の記述はそれぞれ独立しており、後で Hard Flash の硬い光のスタイルに変えたい場合は、style と光線の段落だけを変え、残りの 5 行はそのままにすれば差異を比較できます。

例 2：イメージtoイメージの instruction

<image_1> のカメラアングルを真上からの俯瞰に変更し、人物のポーズ、服装、位置は変更しない。
<image_2> を服装の素材参照とし、コートの織物のテクスチャと光沢は <image_2> に従って処理する。

ここでは image_urls に 2 枚を渡します。1 枚目は編集対象の元画像、2 枚目は素材の参照画像であるため、instruction 内で <image_1>、<image_2> と明示的に指し示す必要があります。指示自体は 2 つのことだけを行います——アングルの変更と、参照画像に従った素材処理——これこそがイメージtoイメージが得意とする範囲です。一度に 1 つの属性だけを変え、それ以外の部分はできるだけ動かさないようにします。変更を単一の次元に抑えることで、手戻りを減らせるだけでなく、今回の呼び出しが期待どおりかどうかも判断しやすくなります。

価格とコンテンツセーフティ

2 つのモデルはいずれも 1 枚 $0.0572 で、課金ルールは比率、スタイル、参照画像の枚数、マスクの有無に一切関係ありません。1:1 と 21:9 は同価格、4 枚送っても 1 枚送っても同価格、mask ありでもなしでも同価格です。費用は出力枚数だけで決まり、100 枚で $5.72、1000 枚で $57.2 です。

コンテンツセーフティについて事前に知っておくべき点が 1 つあります。記述に不適切な内容が含まれる場合、API はエラーを返さず、モデルがプロンプトを安全な内容に書き換えてから生成を続行します。書き換え後の画面は本来の意図と無関係な可能性がありますが、この呼び出しは通常どおり課金されます。そのためプロンプトは送信前に自己チェックが必要で、特に人物、服装、シーンに関わる敏感な記述には注意してください——問題が起きてもエラーではなく、無関係な画像 1 枚と費用が発生するだけです。

API 呼び出し例

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"

イメージtoイメージも同じタスク API を流用し、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 と同じプロンプトで結果を再現できます。イメージtoイメージの seed のデフォルト値も 5555 です。