---
title: "透過 RunAPI 在 Hermes Agent 中使用 Qwen 2 Image — 圖像 API 指南"
url: "https://runapi.ai/zh-HK/hermes-qwen-2.md"
canonical: "https://runapi.ai/zh-HK/hermes-qwen-2"
locale: "zh-HK"
model: "qwen-2"
---

# 在 Hermes Agent 中使用 Qwen 2 Image。

Qwen 2 Image 是 Alibaba 的圖像生成和編輯模型。Hermes Agent 透過 RunAPI 自訂 provider 端點呼叫它——發送 prompt，取回圖像 URL。支援透過三個模型版本進行文字轉圖片、圖像編輯和圖像混合。

## 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": "qwen-2-text-to-image",
    "prompt": "A traditional Chinese ink painting of misty mountains at dawn, elegant brushwork"
  }'

```

### Response

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

```

## How it works

1. **設定 RunAPI** — 將 RunAPI API key 設定為環境變數。如果你尚未將 RunAPI 新增為 Hermes Agent 自訂 provider，請先參照 Hermes Agent 設定指南，以 base_url https://runapi.ai/v1 新增 custom:runapi。
2. **呼叫 Qwen 2 Image** — 將 prompt 貼入 Hermes Agent 或直接呼叫 text_to_image 端點。將 model 欄位設為 qwen-2-text-to-image（生成）、qwen-2-edit-image（編輯）或 qwen-2-remix-image（混合）。
3. **取得結果** — 端點返回 task ID。輪詢 task status 端點直到狀態變為 completed，然後從輸出中讀取圖像 URL。RunAPI SDK 會自動處理輪詢。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。qwen-2-text-to-image、qwen-2-edit-image 或 qwen-2-remix-image。 |
| `prompt` | `string` | 文字描述或編輯指令。 |
| `image_url` | `string` | 編輯或混合模式的來源圖像。 |
| `size` | `string` | 可選。輸出尺寸。 |

## FAQ

### 我可以在 Hermes Agent 中使用 Qwen 2 Image 嗎？

可以。Hermes Agent 支援自訂 OpenAI 相容 provider。將 RunAPI 新增為 custom:runapi，base_url 設為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY，api_mode 設為 chat_completions。然後以 model 設為 qwen-2-text-to-image 呼叫 text_to_image 端點。

### 使用 Qwen 2 Image 需要獨立的 API key 嗎？

不需要。用於聊天模型的同一個 RUNAPI_API_KEY 亦可呼叫 Qwen 2 Image 及 RunAPI 目錄中的所有其他模型。一個 key，一個餘額，一個控制台。

### Qwen 2 Image 是非同步還是同步？

非同步。端點立即返回 task ID。輪詢 task status 端點或使用 webhook callback 以知悉圖像何時就緒。RunAPI SDK 和 CLI 會自動處理輪詢。

### Qwen 2 Image 在 RunAPI 上的收費是多少？

Qwen 2 Image 按任務計費。請查看 RunAPI 收費頁面了解最新價格。無月費訂閱或最低消費——只為完成的生成付費。


## Links

- [Hermes Agent 設定指南 →](https://runapi.ai/zh-HK/hermes-agent)
- [Qwen 2 Image 模型 →](https://runapi.ai/zh-HK/models/qwen-2)
- [Model catalog](https://runapi.ai/zh-HK/models)
- [API docs](https://runapi.ai/zh-HK/docs)