Recraft v4 Styles テキスト生成画像プロンプトレシピ：そのままコピーできるプロンプトと実際の出力

recraft-v4-styles プロンプトの構造分析

画像生成を納品するチームは最終的に必ず同じ壁にぶつかります。誰かが丹念に磨き上げたプロンプトがあり、一度だけ見事な結果を出し、それをノートに貼り付け、六週間後には誰もその結果を再現できないという状況です。そのプロンプトは単発の実行のために調整されたもので、どの語が実際に効いたのかを記録したものは何もありません。モデル、パラメータ、またはチームメンバーが変われば結果は漂い、戻るべき基準も存在しません。

プロンプトレシピはこの問題を解決します。プロンプトを神秘的な文字列ではなく、構造化されバージョン管理された成果物として扱うのです。レシピはプロンプト内で異なる役割を担う部分——主体、スタイル参照、トーン、制約——を分離するため、各部分を意識的に個別に修正できます。この構造は開発者が本当に気にする三つのものを提供します：

• 再現性。 固定されたレシピ、固定されたパラメータ、固定されたシードを使えば、チームは数か月後でも比較可能な画像を再生成できます。
• テスト可能性。 一つのスロットだけが異なる二つのレシピを A/B 比較し、差異をそのスロットに帰属させることができます。
• 学習コスト。 新しいメンバーはレシピライブラリを読むだけでよく、誰かの直感を逆解析する必要はありません。

本ガイドは recraft-v4-styles/text-to-image を対象に、レシピブックの形式で構成されています。各レシピのセクションでは、特定のタスク向けにそのままコピーできるプロンプトパターンを示します：スタイル参照への誘導、イラストトーンの推進、写真トーンの推進です。最後のいくつかのセクションでは、実際の出力を読み取る方法、一度に一つの変数だけを反復する方法、および統一されたモデルインターフェースを通じてアプリケーションコードからレシピを呼び出す方法を説明します。

ここに示すプロンプトは出発点であり、保証ではありません。画像モデルは言い回しに敏感で、细微な変更でも出力が大きく偏移することがあります。各レシピは、あなたが調整し再測定するための基準として扱ってください。

プロンプト構造に関する補足： 明確な区切り文字（句点、改行、またはラベル付きの断片）で各スロットを分離してください。そうすれば、あなたとチームはプロンプトを散文ではなく仕様書として読むことができます。

このレシピブックの使い方

1. 目標とする出力タイプに合ったレシピを選びます（スタイル誘導、イラスト、または写真）。
2. それをコピーし、主体スロットを自分の内容に置き換えて、まず基準として一度実行します。
3. 意図と比較します（「実際の出力を読み取り反復する」を参照）。
4. 一度に一つのスロットだけを調整し、出力の横にその変更を記録します。

このサイクル——レシピ、実行、比較、一箇所だけ変更——が、本記事の以降の内容が依拠する中核的な規律です。

スタイル参照誘導レシピ

イラストトーンレシピ

スタイル参照誘導は recraft-v4-styles の中で最も厳密なプロンプトを必要とする部分です。目標は、生成結果が参照の外観——配色、線の質感、レンダリング処理——を継承しつつ、その文字通りの内容を複製しないことです。信頼できる方法は、参照の視覚的属性をテキストで記述し、それを独立したスロットに置き、主体スロットは分離したままにすることです。

レシピ S1 —— 属性ベースの参照誘導

主体：高い草むらに座るキツネ、斜め前からの視点
スタイル参照：柔らかなアースカラーの配色、柔らかな水彩のぼかし、紙の粒状感が見える、細く不揃いな輪郭線、低对比の影、硬い黒はなし
トーン：穏やかで自然主義的なイラスト
構図：主体を中央に、上部に十分なネガティブスペース
制約：文字なし、署名なし、額縁なし

これは最も移植しやすいレシピです。参照画像を貼り付けるのではなく、その参照を認識可能にしているものを記述します。スタイル名をコピーするよりも、モデルの更新に耐えられます。

レシピ S2 —— 参照強度、軽いタッチ

主体：木製の棚に置かれた陶器のティーポット
スタイル参照：中世ポスターアートへの微妙なオマージュ——簡略化された形、二色配色、わずかな印刷テクスチャ
トーン：抑制的、平面的
制約：単色背景、グラデーションなし、文字なし

「微妙なオマージュ」という表現に注目してください。誘導強度はかなりの程度言い回しの問題です：曖昧な言葉（「微妙なオマージュ」「緩やかに触発された」「軽く呼応する」）は主体を主導的に保ち、強い言葉（「……のスタイルを強く採用する」「……に支配される」）は参照に主導権を渡します。

レシピ S3 —— 参照主導、主体は二次的

スタイル参照：大胆なフラットベクターアート、厚みのある幾何学的形状、彩度の高い補色配色、くっきりしたエッジ、テクスチャなし
主体：山脈、積み重なった三角形に簡略化
トーン：ポスター的、自信に満ちた
制約：文字なし、グラデーションなし、写真的な細部なし

参照が主導すべき場合は、それを最初に置き、主体をすでに参照の視覚言語に翻訳されたものとして記述します（「積み重なった三角形に簡略化」）。これにより、主体は写真的な細部を保ったまま背景だけがフラットになるというよくある失敗を避けられます。

全体を書き換えずに強度を変更する

主体、トーン、制約、構図のスロットをバイト単位で同一に保ち、スタイル参照スロット内の誘導フレーズだけを変更します：

• 軽く呼応する → 微妙なオマージュ → ……の精神に合致する → ……のスタイルを強く採用する

各バリアントをその出力と一緒に記録します。三〜四回実行すれば、その参照の下でどのフレーズが意図に最も近いかが分かり、それをレシピに凍結できます。

よくある落とし穴

• ブランドや存命のアーティストをスタイル参照として指定すると、一貫性のない、時には回避的な結果が得られがちです。代わりに属性を記述してください。
• 同じスロットに二つの参照を混ぜると平均化が起こります。混合が必要な場合は、二つの明確にラベル付けされた参照断片を書き、どちらが主導するかを明示してください。
• 制約を省略すると、文字のアーティファクト、署名、額縁が現れます。

写真トーンレシピ

イラスト出力と写真出力は異なる語彙体系に反応します。レンズや光ではなく、線、形、質感、明暗のモデリングを中心に考えてください。以下のレシピは、すでに主体スロットに自分の内容を入れたことを前提としています。

レシピ I1 —— フラットベクター、ミニマル配色

主体：自転車に乗った配達員
トーン：フラットベクターイラスト
スタイル参照：単色塗り、二色配色にアクセントカラーを一つ、均一な線幅、丸みのある幾何学的形状、グラデーションなし、テクスチャなし
構図：側面からの視点、シンプルな地平線、単色背景
制約：文字なし、影なし、輪郭線の二重化なし

フラット系のレシピは、語彙が二値的（グラデーションなし、テクスチャなし、線幅均一）であるため、一連のセット内で最も一貫性を保ちやすいです。アセットセットの各アイテムに同じ言い回しを使ってください。

レシピ I2 —— 手描き線画

主体：陶器の植木鉢に入った観葉植物
トーン：手描きのインク線画
スタイル参照：細い強弱のあるインク線、わずかな震え、まばらなクロスハッチングで影を表現、オフホワイトの背景、アクセントカラーのにじみを一つ
構図：中央、主体全体が画面内、小さな余白
制約：文字なし、アクセントカラーのにじみ以外の彩色なし

実際に効く言葉は強弱、震え、まばらなクロスハッチングです。それらを外すと凡庸な線画になり、残せば出力はなぞったものではなく描かれたものとして読めます。

レシピ I3 —— 質感のある明暗付きイラスト

主体：夕暮れの岩場の海岸にある灯台
トーン：筆致の質感が見える絵画的なイラスト
スタイル参照：厚みのある不透明な筆致、層状の陰影形状、暖色から寒色への配色の移行、キャンバスの粒状感、選択的に柔らかくしたエッジ
構図：低い地平線、灯台は中央より右
制約：文字なし、写真級のリアリズムなし、レンズフレアなし

明暗のあるイラストでは、明暗がどのように構築されるか——層状の形状、クロスハッチング、柔らかなぼかし——を述べ、「影付き」と言うだけにしないでください。曖昧な明暗の言葉は濁った中間調を生みます。

レシピ I4 —— アイソメトリック技術イラスト

主体：小さなカフェの店内配置
トーン：アイソメトリック技術イラスト
スタイル参照：30 度のアイソメトリック投影、単色、細く均一な輪郭線、シンプルで繰り返しの家具形状、透視歪みなし
構図：シーン全体、ニュートラルな背景、均一な照明
制約：文字ラベルなし、人物なし、シンプルな接地影以外の影なし

アイソメトリック系のレシピは、透視の言葉が混入すると失敗しがちです。投影方式を明示し、写真用語を禁止してください。

語彙クイックリファレンス

• 線： 均一な線幅、強弱、先細り、手描きの震え、くっきりしたエッジ。
• 形： 幾何学的、丸み、簡略化、積み重なった三角形、シルエット優先。
• 質感： 紙の粒状感、キャンバスの粒状感、印刷テクスチャ、なし。
• 明暗： フラット塗り、二色、クロスハッチング、層状の陰影形状、柔らかなぼかし。

実際の出力を読み取り反復する

写真系のレシピは光、レンズ感、素材、フレーミングに依存します。きれいなイラストを生むのと同じ主体の言葉でも、写真スロットを加えなければ平板な「写真」になってしまいます。トーンスロットは簡潔に保ち、技術的特性はスタイル参照スロットに入れてください。

レシピ P1 —— 柔らかな自然光、エディトリアル感

主体：リネンのテーブルクロスの上に置かれた柑橘類の器
トーン：エディトリアルなフードフォトグラフィー
スタイル参照：左側からの柔らかな拡散窓光、浅い被写界深度、50mm 相当の視点、自然な色彩、ハイライトの柔らかな減衰、繊細な粒状感
構図：斜め上からの四分の三視点、主体はやや中心から外れる
制約：文字なし、画面端の外に小道具なし、眩しいハイライトなし

光の方向は最も効果の大きいフレーズです。光源と方向を明示する（「左側からの柔らかな拡散窓光」）方が、「美しい光」よりも安定した結果になります。

レシピ P2 —— 硬い光、製品の鮮明さ

主体：コンクリート表面に置かれたマットブラックのワイヤレススピーカー
トーン：スタジオ製品写真
スタイル参照：右上からの単一の硬いキーライト、くっきりした影のエッジ、マクロ級のクリーンな細部、ニュートラルグレーの背景、わずかな輪郭の分離、色かぶりなし
構図：中央、アイレベル、正方形の構図
制約：文字なし、スタジオの映り込みなし、埃なし

素材の言葉がここでは重要です——マット、コンクリート、ニュートラルグレー——モデルはそれらから表面の応答を推論するからです。素材が正しく読めない場合は、光をいじる前にまず素材の言葉を変えてください。

レシピ P3 —— 現場光のドキュメンタリー

主体：夜の市場の屋台、店主が農産物を整えている
トーン：ドキュメンタリーのストリートフォトグラフィー
スタイル参照：現場光、混合色温度、見える粒状感、背景の人物のわずかなモーションブラー、35mm 相当の視点、深めだが不完全な被写界深度
構図：スナップショット、アイレベル、主体が屋台の端で部分的に縁取られる
制約：文字の重ね合わせなし、作られた表情なし、スタジオ照明なし

ドキュメンタリー系のレシピには許容的な語彙が必要です：スナップショット、現場光、不完全なフォーカス。これらがないと、モデルは洗練された演出写真の外観にデフォルトします。

レシピ P4 —— 風景、望遠圧縮

主体：日の出時の層状に重なる山稜
トーン：風景写真
スタイル参照：望遠圧縮、距離に応じて増す大気の霞、寒色の影と暖色のハイライト、高いダイナミックレンジだが空はクリーン、目立つノイズなし
構図：山稜線が水平に積み重なる、地平線は下三分の一
制約：文字なし、人物なし、レンズフレアのアーティファクトなし

語彙クイックリファレンス

• 光： 拡散窓光、硬いキーライト、輪郭の分離、現場光、混合色温度。
• レンズ感： 浅い被写界深度、望遠圧縮、広角視点、マクロ級のクリーンな細部。
• 素材： マット、ヘアライン、コンクリート、リネン、鏡面反射と拡散反射の応答。
• フレーミング： アイレベル、斜め上からの四分の三視点、中心から外す、地平線の位置。

集約 API を通じてレシピを提供する

レシピは、出力が意図に合致するかを判断できて初めて役に立ちます。多くのチームが犯す間違いは、結果を「良い」か「悪い」かで評価し、どのスロットが失敗したかを問わないことです。画像を見る前に、各スロットが本来何を生むべきかを書き留めてください：

• 主体： 文字通りの内容——それは現れ、正しく記述されているか？
• スタイル参照： 表面処理——配色、線、質感、光の特性。
• トーン： 全体的な調性——穏やか、大胆、エディトリアル、スナップショット的。
• 構図： 各要素の画面内の位置。
• 制約： ネガティブ項目——文字なし、グラデーションなし、余分な小道具なし。

次に行ごとに画像を照合して確認します。主体は正しいが質感が間違っている結果は、レシピの失敗ではなく質感フレーズの失敗です。この区別こそが反復を速くします。

単一変数のルール

毎回の実行では一つのスロットだけを変更し、残りはすべて固定します——パラメータ、およびサポートされている場合はシードも含めて。二箇所を変えて出力が良くなったとしても、再現できるものは何も学んでいません。

実用的なサイクル：

1. レシピをそのまま実行する。出力を完全なレシピテキストとパラメータと一緒に保存する。
2. 書き留めた意図に照らして、各スロットを合格/不合格で採点する。
3. 最も悪いスロットを選ぶ。
4. そのスロットだけを編集する——語彙を精練し、制約を追加し、または矛盾するフレーズを削除する。
5. 再実行する。前回の出力と並べて比較する。
6. あるスロットが合格したら、その言い回しを凍結し、次に最も悪いスロットへ移る。

よくある失敗パターンの識別

• 制約の漏れ。 「文字なし」の制約にもかかわらず、文字や署名が現れる。原因は通常、主体やトーンのフレーズが「ポスター」や「ラベル」のようなタイポグラフィを暗示していることです。ネガティブ語を繰り返すのではなく、その暗示を削除してください。
• スタイルの平均化。 二つの参照が混ざって一团になる。一つの主導的な参照を選び、もう一方を修飾語に格下げしてください。
• スロットの衝突。 主体スロットがレンダリング方法を記述し（「水彩のキツネ」）、スタイルスロットもレンダリング方法を記述している。レンダリングの言葉を主体スロットに入れないでください。
• 過剰指定。 長いプロンプトに何十もの形容詞を詰め込むと、それぞれが薄まります。測定可能な効果のないフレーズは削除してください。

レシピライブラリの構築

各レシピを構造化テキストとして保存し、バージョン番号、使用したパラメータセット、固定した場合のシード、およびその出力へのリンクを添付します。レシピの変更はコードの変更として扱います：何を、なぜ変更したかを記録してください。後で二つのレシピを A/B 比較するとき、差異は意図したものだけであるべきで、公平な比較のためにシードとパラメータを固定すべきです。

すべてを固定しても、ある程度の変動は正常です——レシピは再現可能な基準として扱い、ビット単位の正確さの保証とはせず、出力ログをレシピと一緒に置いて比較を誠実に保ってください。

集約 API を通じてレシピを提供する

レシピが安定したら、それはコードに入るべきです——漂う共有ドキュメントの中に横たわっているべきではありません。目標は、プロンプトをバージョン付きの値にし、アプリケーションがそれを組み立て、送信し、記録し、書き直すことなく差し替えられるようにすることです。

スロットからプロンプトを組み立てる

各スロットを独立したフィールドとして保存し、リクエスト時に連結します。これにより、テストで一つのスロットを変えるときに文字列の残りをコピーする必要がなくなります：

recipe = {
    "id": "photo-p1-citrus",
    "version": 3,
    "subject": "リネンのテーブルクロスの上に置かれた柑橘類の器",
    "style": "左側からの柔らかな拡散窓光、浅い被写界深度、"
             "自然な色彩、繊細な粒状感",
    "tone": "エディトリアルなフードフォトグラフィー",
    "composition": "斜め上からの四分の三視点、主体はやや中心から外れる",
    "constraints": "文字なし、眩しいハイライトなし",
}

prompt = "。".join(
    [recipe["subject"], recipe["tone"], recipe["style"],
     recipe["composition"], recipe["constraints"]]
)

id と version が鍵です：生成された各画像は、それを生み出した正確なレシピ改訂版に追跡可能であるべきです。

パラメータを一貫して渡す

再現性に影響するパラメータ——サイズ、サポートされている場合はシード、モデルが公開するスタイルまたは強度の制御——を、各呼び出し箇所に散らかすのではなく、レシピごとの一つの設定オブジェクトに固定します。A/B 比較の際は、バージョン番号だけが変わっているべきです。

一つの統一 API を通じてルーティングする

各モデルベンダーを個別に統合するのではなく、HiAPI.ai の単一の OpenAI 互換エンドポイントを通じてリクエストを送信します。これにより、recraft-v4-styles/text-to-image の背後にあるモデルが変わってもレシピコードは安定し、モデル識別子を交換するだけで別のモデルでレシピをテストできます——新しい SDK も、新しい認証フローも、プロンプト組み立てロジックの書き直しも不要です。クライアントを https://api.hiapi.ai/v1 に向け、レシピのバージョン管理はあなた自身のコードに残してください。

本当に重要なものを記録する

各生成について、レシピ id とバージョン、解決後のプロンプト文字列、各パラメータ、返された画像参照、および一行の意図説明を記録します。このログがあなたの A/B テストツールであり、将来モデルの更新で出力が偏移したときのデバッグ手がかりでもあります。

レシピを基準としてコピー＆ペーストし、一度に一つのスロットを反復し、それをバージョン付きの記録として凍結し、HiAPI.ai を通じて提供する——まさにこのワークフローが、一つの幸運なプロンプトを信頼できるパイプラインに変えるのです。