OpenClaw で Flux Kontext を使う。
Flux Kontext(Black Forest Labs 製)はキャラクターの一貫性を保ちながらテキスト誘導の画像編集・生成を行います。OpenClaw エージェントは RunAPI を通じて呼び出します。チャットで使用している API キーと同じキーでプロンプトを送るだけで画像 URL が返ってきます。
Use RunAPI to generate an image with Flux Kontext Pro.
Requirements:
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- Use the RUNAPI_API_KEY environment variable for authorization
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL
curl -X POST https://runapi.ai/v1/text_to_image \
-H "Authorization: Bearer $RUNAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-kontext-pro",
"prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "flux-kontext-pro"
}
3 ステップで OpenClaw で Flux Kontext を使う
RunAPI を設定する
RUNAPI_API_KEY 環境変数を設定します。すでに OpenClaw プロバイダーとして RunAPI をチャット用に設定済みであれば、同じキーで画像生成が可能です。追加設定は不要です。
export RUNAPI_API_KEY=runapi_xxx
Flux Kontext を呼び出す
model を flux-kontext-pro に設定して text_to_image エンドポイントに POST リクエストを送ります。生成したい画像を説明するテキストプロンプトを含めてください。インコンテキスト編集には image_url を渡します。
text_to_image
結果を取得する
エンドポイントはタスク ID を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスから生成された画像 URL を取得します。
task_id: tsk_abc123
Flux Kontext API パラメーター
| パラメータ | 型 | 説明 |
|---|---|---|
model |
string |
必須。flux-kontext-pro または flux-kontext-max。 |
prompt |
string |
生成または編集のテキスト指示。 |
image_url |
string |
インコンテキスト編集用のソース画像 URL。 |
aspect_ratio |
string |
省略可。出力アスペクト比。 |
OpenClaw上のFlux Kontextとは?
Flux KontextはBlack Forest Labsによる継続的画像編集モデルです。変更したい部分をテキストで説明するだけでその部分のみを修正し、残りはそのまま保持します——服を変えても顔は変わらず、背景を差し替えても商品の位置はそのままです。OpenClaw agentはRunAPIのtext_to_imageエンドポイント経由で呼び出します。
Flux Kontextの活用例
被写体を保持した背景置換
商品やポートレートの背景を、被写体がまったく同じ位置のまま置換します——マスキングも修復も不要で、テキスト指示1つで完了します。
服装・外見の変更
顔の特徴を維持したまま服・髪色・アクセサリーを変更し、ファッションモックアップやキャラクターデザインの反復作業に活用します。
看板・ラベルのテキスト置換
既存画像の看板・商品ラベル・店舗のテキストを置換します——プロンプトに新しいテキストを入力するだけでFlux Kontextが所定位置にレンダリングします。
Flux Kontext + OpenClaw よくある質問
はい。OpenClaw で RunAPI を OpenAI 互換プロバイダーとして設定し、model を flux-kontext-pro に設定して text_to_image エンドポイントを呼び出します。チャットで使用している RUNAPI_API_KEY と同じキーで画像生成が可能です。
いいえ。同じ RUNAPI_API_KEY で LLM、画像、動画、音楽を含むすべての RunAPI モデルが利用できます。1 つのキー、1 つの請求アカウントです。
非同期です。API は即座にタスク ID を返します。タスクステータスエンドポイントをポーリングするか、webhook コールバックを使って完成した画像 URL を受け取ります。
Flux Kontext Pro は 1 枚あたり 2.5 セントからです。Flux Kontext Max はより高い忠実度のためにコストが高くなります。現在の料金は RunAPI 料金ページで確認してください。従量制で、サブスクリプション不要です。
今すぐ OpenClaw で Flux Kontext を試す。
無料の RunAPI キーを取得し、プロンプトを OpenClaw に貼り付けて、Flux Kontext で画像生成を始めましょう。