使用ガイド
EC製品画像向けの Flux-2 テキストtoイメージ:プロンプトレシピと利用可能な HiAPI リクエスト
アングル、照明、精密なディテールのプロンプトテンプレートに加え、コピー&ペースト可能な HiAPI リクエストとバッチパターン
このページの内容
flux-2/text-to-image がEC商品カタログに適している理由
商品画像の制作にはコスト曲線の難題があります。各 SKU には複数のアングル、一貫した照明、クリーンな背景が必要であり、「もう一つバリエーションを追加する」ことの限界コストは撮影でもレタッチでも高くつきます。しっかりした製品説明と再現可能なプロンプトがあれば、テキストtoイメージはこの計算を変えます。
テキストtoイメージが有利な場面
- ロングテールとバリエーション SKU。 専用撮影に見合わない色、サイズ、構成でも、カタログにそのまま載せられる画像が得られます。
- コンセプト画像とプレースホルダー画像。 カテゴリページ、A/B テスト、公開前の商品リストには、実物サンプルが届く前に信頼できる見た目の画像が必要です。
- スタイル探索。 背景と照明の方向を素早くテストし、本番撮影を予約する前にビジュアルの方向性を固められます。
撮影で代替できない場面
購入者の判断が実物のディテール——縫い目、摩耗、認証タグ、実光下での正確な色——にかかっている場合、生成画像はあくまでコンセプトであり、証拠ではありません。実際に出荷する製品を表現できる場合にのみ、flux-2/text-to-image の出力をカタログ素材として扱うべきです。正確性が売りであるメイン画像には、実写を残してください。
image-to-image と比べ、text-to-image はプロンプトへの要求が高くなります。構図を固定する参照画像がないからです。ここがトレードオフです。アングル、照明、背景を完全に制御できる代わりに、それらを明示的に記述しなければなりません。本ガイドの残りは、この記述を再現可能にする方法についてです。

SKU をまたいで安定して再利用できる基本プロンプト構造
ある製品には効くのに別の製品では効かないプロンプトは、通常、製品固有の事実とシーン上の決定を混ぜてしまっていることが原因です。それらを分離しましょう。
6スロットの骨格
[被写体] — [アングル] — [照明] — [背景] — [ディテール] — [スタイル/制約]
- 被写体: 物体が何か、素材、色、および決定的な形状。事実ベースで保ちます。
- アングル: 製品に対するカメラの位置(正面斜め45度、俯瞰、アイレベル)。
- 照明: ソフトボックスのキーライト、リムライト、影の柔らかさ、方向。
- 背景: 表面、色、およびピントが合っているかどうか。
- ディテール: 購入者が確認する2〜3の特徴。
- スタイル/制約: コマーシャル製品写真、シャープなフォーカス、テキストなし、中央構図。
記入済みの例
深いフォレストグリーンのマットなセラミック製コーヒーマグ、正面斜め45度のアングル、アイレベル高さ、
左上からの柔らかな拡散キーライト、右エッジに微妙なリムライト、シームレスなライトグレーの背景、
マットな釉薬の質感と滑らかなハンドルの曲線が視認できる、コマーシャル製品写真、シャープなフォーカス、
テキストなし、ロゴなし、中央構図
スロットを安定させ、事実だけを差し替える
骨格を生成スクリプトに一度保存し、各 SKU では被写体とディテールのスロットだけを注入します。アングル、照明、背景、スタイルはバッチ内で固定されたままにします——これこそが一連の画像をコラージュではなく同一カタログのように見せる理由です。第二の視点(俯瞰、側面)が必要なときは、1つのスロットだけを変えます。そうすれば視覚的な差異はその変更に起因すると特定できます。
実用的な習慣:書くプロンプトはすべて同じスロット順を保ちます。モデルは構造に従い、半年後にあなたのプロンプトライブラリをレビューする人も同様です。
カメラアングルと照明のプロンプトレシピ
これらのテンプレートは [被写体] スロットの直後に貼り付ける設計です。背景色はブランドのベースカラーに合わせて差し替えてください。
アングルのレシピ
正面斜め45度(デフォルトのメイン画像アングル)
正面斜め45度の視点、カメラは製品の中間高さ、製品は中央、
製品全体が見え、四方に少し余白がある
アイレベル / 正対
正対したアイレベル視点、カメラは製品の正面と平行、
パースの歪みなし、製品は中央
俯瞰フラットレイ
真上からの俯瞰視点、カメラは表面に対して垂直、
製品は中央で余白が均等、下に平坦な影
やや見下ろし(箱入り商品に適す)
製品の上方30度から見た視点、正面と天面の両方が見える、
カメラは製品中心に向かって傾く
照明のレシピ
柔らかなスタジオライト(堅実なデフォルト)
左上からの大型ソフトボックスキーライト、右側に白い補助レフ板、
製品の下に柔らかなコンタクトシャドウ、ギラつくハイライトなし
サイドライトで質感を強調
左からの斜め入射サイドライトで表面の質感を表現、正面に柔らかな補助光、
影は右側に落ちる、背景は均一に照らされる
クリーンなカタログホワイト
45度の柔らかな光源2つで明るく均一な照明、影はごく僅か、
シームレスな白背景、製品のエッジがはっきり分離
ムードのあるアクセント(ライフシーン寄り)
右上からの単一指向性キーライト、濃いグレーの背景へ深く減衰、
一辺に柔らかなハイライト、制御された影
共通の構図のポイント
- パースが重要な場合はカメラ高さを明記する。「中間高さ」と「俯瞰」では輪郭が明らかに異なります。
- 影がどこに落ちるかを明記する。影の未指定はバッチの不整合で最もよくある原因です。
- 余白の表現を固定する(「四方に少し余白」)。そうすれば製品がバッチ全体で異なるトリミングにならずに済みます。
1つのアングルレシピと1つの照明レシピを組み合わせれば、安定したマトリクスが得られます。4アングル×4照明設定で、単一の骨格から16通りの見た目になります。

プロンプト追従性と高忠実度ディテールを高める表現
追従の問題は、形容詞が少なすぎることではなく、曖昧な名詞から生じることが多いです。「美しい、高級、驚くべき」を積み重ねてもスタイルのノイズが増えるだけで、モデルに何を描くべきかを伝えられません。
素材を正確に名指す
「良い生地」を実際の表面に置き換えます:ヘアラインアルミニウム、マット粉体塗装スチール、型押しレザー、フロストガラス、未晒しコットンキャンバス。素材の語は質感と反射率を運ぶため、どんなスタイル形容詞よりも有用です。
気になるものを制約する
モデルは暗黙の願望よりも明示的な制限によく従います。制約は画像についての陳述として書きます:
製品は画面幅の約70%を占める
ロゴ領域は空白でマークなし
ラベル文字は空白領域として描画され、文字なし
画面内に製品は1つだけ、小道具なし
各行が自由度を1つ排除します。制約は短く、字義通りに保ちます——長い禁止文はしばしば崩れてしまいます。
ディテールを称賛するのではなく指し示す
- 弱い:
極めて精細で高品質 - 強い:
上端に縫い目が見え、レザー表面に微細なテクスチャ、金属バックルにヘアライン仕上げ
高忠実度のディテールは、購入者がズームする2〜3の特徴を名指しし、残りはレンダラーに任せることで得られます。あるディテールが重要なら、その重要性ではなく、位置と素材を記述してください。
シーン語の制御でドリフトを抑える
スタイル語は無料ではありません。ドラマチック、シネマティック、ラグジュアリーはいずれも照明とコントラストを変えます。カタログがクリーンでニュートラルなら、それらを外すか、クリーンなコマーシャル照明、ドラマチックな影なしのような明示的な修正と組み合わせます。すべてのスタイル指示に対応する物理的な記述があるとき、追従性は向上します。
もう一つ身につける価値のある習慣:製品カテゴリごとに、どの制約行を追加したかを記録します。出力がドリフトしたとき、当て推量ではなくプロンプトの差分を比較できます。
よくある製品画像の失敗を防ぐネガティブワードリスト
ネガティブプロンプトはメスであってバケツではありません。実際に観察した失敗パターンに焦点を当てた短いリストは、有効なレンダリングを抑制しうる汎用の除外の壁よりも優れています。
簡潔な開始リスト
文字、透かし、ロゴ、余分な手足、製品の重複、雑然とした背景、
ギラつく鏡面ハイライトの白飛び、モーションブラー、幾何学的な歪み、製品エッジのトリミング
各項目を残す価値がある理由
- 文字、透かし、ロゴ —— 生成された文字はほとんど使えず、しばしば文字化けします。誤りより空白が良いです。
- 製品の重複 —— 背景スロットが曖昧なときに複数物体のシーンが混入します。
- 雑然とした背景 —— クリーンなカタログの見た目を守ります。
- ギラつく鏡面ハイライトの白飛び —— 光沢製品はハイライトの白飛びで表面のディテールを失います。
- 幾何学的な歪み —— アングルスロットの記述が不足するとハンドル、注ぎ口、エッジが曲がります。
- 製品エッジのトリミング —— 余白の表現と連動して、完全な輪郭を画面内に保ちます。
カテゴリ別に分ける
積み重ねるのではなく追加します。ガラス器具には二重反射、不透明ガラスを加えると良いです。衣料品にはマネキン、実モデル、折りたたんだ衣類を加えると良いです。食品系製品には結露、付け合わせ、小道具を加えると良いです。あるカテゴリが安定したら、該当項目を削除します。短いネガティブリストのほうがポジティブプロンプトを主導させられます。
経験則
特定の出力で見た失敗を指し示せないなら、ネガティブリストに加えないでください。リストは予想からではなくレビューから育てましょう。
実行可能な flux-2/text-to-image HiAPI リクエスト
以下のリクエストは HiAPI の統一インターフェースを通じて flux-2/text-to-image にプロンプトを送信します。プロンプト文字列を差し替えれば、最初の製品画像が得られます。
リクエスト
curl -X POST "https://api.hiapi.ai/v1/images/generations" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/text-to-image",
"prompt": "深いフォレストグリーンのマットなセラミック製コーヒーマグ、正面斜め45度の視点、カメラは製品の中間高さ、製品は中央で四方に少し余白、左上からの大型ソフトボックスキーライト、右側に白い補助レフ板、製品の下に柔らかなコンタクトシャドウ、シームレスなライトグレーの背景、マットな釉薬の質感と滑らかなハンドルの曲線が視認できる、コマーシャル製品写真、シャープなフォーカス、テキストなし、ロゴなし",
"negative_prompt": "文字、透かし、ロゴ、製品の重複、雑然とした背景、ギラつく鏡面ハイライトの白飛び、幾何学的な歪み、製品エッジのトリミング",
"aspect_ratio": "1:1",
"n": 1
}'
フィールドごとの説明
- model —— 呼び出しを flux-2 テキストtoイメージにルーティングしたままにします。明示的に固定することで、将来のデフォルト変更がカタログの見た目を黙って変えることを防ぎます。
- prompt —— 前述の6スロット骨格を、1つのアングルと1つの照明レシピで組み立てたものです。
- negative_prompt —— 簡潔な除外リスト。出力をレビューしながらカテゴリ別に調整します。
- aspect_ratio —— チャネルごとに固定します(グリッドタイルは正方形、モバイルのリストカードは縦長)。バッチを統一するためです。
- n —— プロンプト最適化中は1に保ち、選択肢となるバリエーションが欲しいときに上げます。
レスポンスの読み方
API は生成された画像データとリクエストメタデータを含む JSON オブジェクトを返します。画像ペイロードを解析し、ストレージに書き込みます。キー名には SKU とアングル/照明の組み合わせを含め(例:mug-green__front34__soft-studio)、ファイルの隣に正確なプロンプトを記録します。この「ファイル名+プロンプト」のペアが、後続の QA と再生成を実行可能にします。課金はプラットフォーム標準の画像生成計量に従うため、仮定をスクリプトにハードコードするのではなく、アカウントの料金パネルで現在のレートを確認してください。
SKU リストをまたいだバッチプロンプト生成
単発のリクエストが通れば、バッチ処理はテンプレート注入とループです。骨格はコードに、製品の事実はデータに置きます。
パターン
ANGLES = {
"front34": "正面斜め45度の視点、カメラは製品の中間高さ、製品は中央で四方に少し余白",
"flat": "真上からの俯瞰視点、カメラは表面に対して垂直、製品は中央で余白が均等、下に平坦な影",
}
LIGHTING = "左上からの大型ソフトボックスキーライト、右側に白い補助レフ板、製品の下に柔らかなコンタクトシャドウ"
STYLE = "コマーシャル製品写真、シャープなフォーカス、テキストなし、ロゴなし、中央構図"
def build_prompt(sku, angle_key):
return f"{sku['subject']}, {ANGLES[angle_key]}, {LIGHTING}, {sku['background']}, {sku['detail']}, {STYLE}"
各 SKU について必要なアングルキーを反復し、プロンプトを構築し、API を呼び出し、結果を決定的なファイル名の場所に保存します。呼び出しの間に短いスリープを入れ、一時的な失敗に対してはバックオフ付きでリトライします。カタログのバッチ実行はレイテンシに敏感ではないため、速度より安定性を優先します。
スケールを広げる前に確認すること
- プロンプトの組み立てが決定的である。 同じ SKU とアングルは常に同じプロンプト文字列を生成しなければなりません。証明が必要なら、各プロンプトのハッシュを記録します。
- 固定スロットの値が本当に固定されている。 背景、照明、スタイルは定数から来るべきで、混入した個別データから来てはいけません。
- アスペクト比は呼び出し地点ではなくチャネルごとに設定する。 設定の一箇所に置き、ループ内に散らばめません。
- ストレージキーにアングルと照明を含める。 後で単一セルを再生成することになるので、アドレス可能にしておきます。
- まず小規模なパイロットを実行する。 すべてのアングルをカバーする10個の SKU で、完全なリスト処理の前にレビューします。
コストと時間の見積もり
生成時間はプロンプト数ではなく画像数に比例して増えるため、画像1枚につき1回の呼び出しで予算を組み、それを軸にバッチを計画します。バッチ実行中は n を1に保ち、レビューを通らなかった SKU のみバリエーションを生成します——同じプロンプトで n を上げるほうが、不要な第二アングルよりはるかに推論しやすいです。
商品カタログに入れる前の出力レビュー
見た目は良いが製品を誤って表現している生成画像は、画像がないより悪いです。公開前にすべての出力に短く一貫した QA チェックを実行します。
チェックリスト
- アングルがラベルと一致する。
front34という名前のファイルは本当に正面斜め45度でなければなりません。各画像が単体で良く見えても、アングルの不一致はグリッドの一貫性を壊します。 - 製品全体が画面内にある。 トリミングされたエッジがなく、製品が画面境界に触れていないこと。
- 文字がない。 文字、透かし、ロゴのアーティファクトがあれば、再生成またはフォールバックを意味します。
- ブランド適合。 背景色、影の柔らかさ、コントラストは既存カタログと並べて調和すべきで、浮いてはいけません。
- 代表性。 表示される製品は実際の出荷と一致しなければなりません:色が正しく、素材が正しく、比率が正しいこと。
再生成かフォールバックか
失敗が見た目上のものでプロンプトで修正できる場合(影の方向が違う、背景がドリフトする、余分な小道具)は再生成します。問題のスロットを引き締めて再実行します。失敗が事実上のものである場合——モデルが特徴を捏造した、素材が誤った仕上げに見える、製品形状が忠実でない——は撮影、image-to-image、またはプレースホルダー画像にフォールバックします。実物と合わない問題を確実に修正できるプロンプト変更はありません。
レビューを低コストに保つ
1枚ずつ見るのではなく、SKU ごとにすべてのアングルを並べたコンタクトシートでレビューします。単体では見えない差異——影の反転、背景のずれ——が並べると明らかになります。拒否のたびにプロンプトハッシュを記録すれば、繰り返す問題は一回限りのノイズではなくプロンプトの問題として顕在化します。これをバッチに対して行うと、ほとんどの失敗が少数の繰り返し現れるスロット値に集中していることが分かり、それらこそ一度に直す価値があります。