---
title: "透過 RunAPI 在 OpenClaw 中使用 Flux Kontext — 圖像 API 指南"
url: "https://runapi.ai/zh-HK/openclaw-flux-kontext.md"
canonical: "https://runapi.ai/zh-HK/openclaw-flux-kontext"
locale: "zh-HK"
model: "flux-kontext"
---

# 在 OpenClaw 中使用 Flux Kontext。

Black Forest Labs 的 Flux Kontext 支援文字引導的圖像編輯與生成，並具備角色一致性。OpenClaw agent 透過 RunAPI 使用與聊天相同的 API key 呼叫它——發送 prompt，取回圖像 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 設定為聊天 provider，同一個 key 亦適用於圖像生成——無需額外設定。
2. **呼叫 Flux Kontext** — 向 text_to_image 端點發送 POST 請求，將 model 設為 flux-kontext-pro，並附上描述所需圖像的文字 prompt。如需上下文編輯，可選擇性傳入 image_url。
3. **取得結果** — 端點返回 task ID。輪詢 task status 端點直到狀態變為 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 相容 provider，然後以 model 設為 flux-kontext-pro 呼叫 text_to_image 端點。用於聊天的同一個 RUNAPI_API_KEY 亦適用於圖像生成。

### 使用 Flux Kontext 需要獨立的 API key 嗎？

不需要。同一個 RUNAPI_API_KEY 適用於所有 RunAPI 模型——LLM、圖像、影片和音樂。一個 key，一個計費帳戶。

### Flux Kontext 是非同步還是同步？

非同步。API 立即返回 task ID。輪詢 task status 端點或使用 webhook callback 接收已完成的圖像 URL。

### Flux Kontext 的收費是多少？

Flux Kontext Pro 每張圖片起價 2.5 美分。Flux Kontext Max 畫質更高，價格亦較貴。請查看 RunAPI 收費頁面了解最新價格——按用量付費，無需訂閱。


## Links

- [OpenClaw 設定指南 →](https://runapi.ai/zh-HK/openclaw)
- [Flux Kontext 模型 →](https://runapi.ai/zh-HK/models/flux-kontext)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)