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

# 在 OpenClaw 中使用 Seedream。

Seedream 是 Bytedance 的圖像生成模型，具備強大的排版渲染能力，輸出最高可達 4K。OpenClaw agent 透過與聊天相同的 RunAPI key 和端點呼叫它——無需額外 skills 或 provider 帳戶。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/task/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5-text-to-image",
    "prompt": "A premium coffee bag on a marble countertop, warm morning light, bold serif text FRESH ROAST, 4K product photography"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "seedream-4.5-text-to-image"
}

```

## How it works

1. **設定 RunAPI** — 如果你已在 OpenClaw 中為聊天設定了 RunAPI，則無需額外操作。同一個 RUNAPI_API_KEY 和 /v1 端點亦可處理圖像生成。如尚未設定，請從 OpenClaw 指南貼入設定 prompt，或在 shell 中匯出 key。
2. **呼叫 Seedream** — 向 text_to_image 端點發送請求，將 model 設為 seedream-4.5-text-to-image，並附上描述圖像的文字 prompt。RunAPI 立即返回 task ID。
3. **取得結果** — 使用返回的 task ID 輪詢 task status 端點。當狀態變為 completed 時，回應中包含生成的圖像 URL。RunAPI SDK 會自動處理輪詢。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。seedream-4.5-text-to-image、seedream-4.5-edit、seedream-5-lite-text-to-image。 |
| `prompt` | `string` | 描述所需圖像的文字。 |
| `size` | `string` | 可選。輸出尺寸。最高支援 4K。 |
| `image_url` | `string` | 編輯模式的來源圖像。 |

## FAQ

### 我可以在 OpenClaw 中使用 Seedream 嗎？

可以。在 OpenClaw 中將 RunAPI 設定為 OpenAI 相容 provider，然後以 model 設為 seedream-4.5-text-to-image 呼叫 text_to_image 端點。同一個 API key 同時處理聊天和圖像生成。

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

不需要。用於聊天的同一個 RUNAPI_API_KEY 亦可呼叫 Seedream 及 RunAPI 目錄中的所有其他圖像模型。一個 key，一個計費帳戶。

### Seedream 是非同步還是同步？

非同步。RunAPI 在第一次呼叫時返回 task ID。輪詢 task status 端點直到狀態為 completed，然後從回應中取得圖像 URL。SDK 和 CLI 會自動處理輪詢。

### Seedream 的收費是多少？

Seedream 按每次生成計費。請查看 RunAPI 收費頁面了解最新價格。生成失敗不收費。


## Links

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