---
title: "OpenClaw で Flux Kontext を RunAPI 経由で使う — 画像 API ガイド"
url: "https://runapi.ai/ja/openclaw-flux-kontext.md"
canonical: "https://runapi.ai/ja/openclaw-flux-kontext"
locale: "ja"
model: "flux-kontext"
---

# OpenClaw で Flux Kontext を使う。

Flux Kontext（Black Forest Labs 製）はキャラクターの一貫性を保ちながらテキスト誘導の画像編集・生成を行います。OpenClaw エージェントは RunAPI を通じて呼び出します。チャットで使用している API キーと同じキーでプロンプトを送るだけで画像 URL が返ってきます。

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

```

## How it works

1. **RunAPI を設定する** — RUNAPI_API_KEY 環境変数を設定します。すでに OpenClaw プロバイダーとして RunAPI をチャット用に設定済みであれば、同じキーで画像生成が可能です。追加設定は不要です。
2. **Flux Kontext を呼び出す** — model を flux-kontext-pro に設定して text_to_image エンドポイントに POST リクエストを送ります。生成したい画像を説明するテキストプロンプトを含めてください。インコンテキスト編集には image_url を渡します。
3. **結果を取得する** — エンドポイントはタスク ID を返します。ステータスが completed に変わるまでタスクステータスエンドポイントをポーリングし、レスポンスから生成された画像 URL を取得します。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必須。flux-kontext-pro または flux-kontext-max。 |
| `prompt` | `string` | 生成または編集のテキスト指示。 |
| `image_url` | `string` | インコンテキスト編集用のソース画像 URL。 |
| `aspect_ratio` | `string` | 省略可。出力アスペクト比。 |

## FAQ

### OpenClaw で Flux Kontext を使えますか？

はい。OpenClaw で RunAPI を OpenAI 互換プロバイダーとして設定し、model を flux-kontext-pro に設定して text_to_image エンドポイントを呼び出します。チャットで使用している RUNAPI_API_KEY と同じキーで画像生成が可能です。

### Flux Kontext に別の API キーが必要ですか？

いいえ。同じ RUNAPI_API_KEY で LLM、画像、動画、音楽を含むすべての RunAPI モデルが利用できます。1 つのキー、1 つの請求アカウントです。

### Flux Kontext は非同期ですか、同期ですか？

非同期です。API は即座にタスク ID を返します。タスクステータスエンドポイントをポーリングするか、webhook コールバックを使って完成した画像 URL を受け取ります。

### Flux Kontext のコストは？

Flux Kontext Pro は 1 枚あたり 2.5 セントからです。Flux Kontext Max はより高い忠実度のためにコストが高くなります。現在の料金は RunAPI 料金ページで確認してください。従量制で、サブスクリプション不要です。


## Links

- [OpenClaw セットアップガイド →](https://runapi.ai/ja/openclaw)
- [Flux Kontext モデル →](https://runapi.ai/ja/models/flux-kontext)
- [Model catalog](https://runapi.ai/ja/models)
- [API docs](https://runapi.ai/ja/docs)