---
title: "透過 RunAPI 在 Hermes Agent 中使用 Recraft — 放大與去背"
url: "https://runapi.ai/zh-TW/hermes-recraft.md"
canonical: "https://runapi.ai/zh-TW/hermes-recraft"
locale: "zh-TW"
model: "recraft"
---

# 在 Hermes Agent 中使用 Recraft。

Recraft 提供清晰的神經網路圖片放大功能，能在不產生偽影的情況下恢復精細細節，以及精準的去背功能，能保留髮絲與透明邊緣。Hermes Agent 透過與聊天相同的 RunAPI custom provider 呼叫這兩個端點 — 傳送來源圖片 URL，選擇放大或去背，然後輪詢處理結果。

## API example

```bash
curl -X POST https://runapi.ai/api/v1/recraft/upscale_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraft-crisp-upscale",
    "source_image_url": "https://example.com/product-photo.jpg"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "recraft-crisp-upscale"
}

```

## How it works

1. **設定 RunAPI** — 如果您尚未在 Hermes Agent 中設定 RunAPI，請依照 Hermes Agent 設定指南操作。新增名為 runapi 的 custom provider，base_url 設為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY，api_mode 設為 chat_completions。
2. **呼叫 Recraft 放大或去背** — 向 upscale_image 端點發送 POST 請求，model 設為 recraft-crisp-upscale 並提供 source_image_url。若要去背，改為向 remove_background 端點發送 POST 請求，model 設為 recraft-remove-background。兩者都只需提供 source_image_url。
3. **輪詢結果** — 兩個端點都會回傳帶有 pending 狀態的 task_id。輪詢任務狀態端點，直到狀態變為 completed，然後從回應中取得處理後的圖片 URL。RunAPI SDK 和 CLI 會自動處理輪詢。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。recraft-crisp-upscale 用於放大，recraft-remove-background 用於去背。 |
| `source_image_url` | `string` | 必填。要處理的來源圖片 URL。 |
| `callback_url` | `string` | 選填。用於非同步完成通知的 Webhook URL。 |

## FAQ

### 可以在一個 Hermes Agent 工作流中串聯 Recraft 去背和放大嗎？

可以。兩個端點都是無狀態的，接受標準圖片 URL。指示 Hermes Agent 先用原始圖片呼叫 remove_background，然後將輸出 URL 傳給 upscale_image。同一個 custom:runapi provider 即可處理兩次呼叫。

### Recraft 接受和輸出什麼圖片格式？

Recraft 接受 JPEG、PNG 和 WebP 輸入。去背輸出帶有 alpha 透明度的 PNG。放大輸出與輸入格式相同。

### 在 Hermes Agent 中如何切換放大和去背？

更改端點路徑和 model 欄位。使用 /api/v1/recraft/upscale_image 搭配 model recraft-crisp-upscale 進行放大，或使用 /api/v1/recraft/remove_background 搭配 model recraft-remove-background 進行去背。兩者使用同一個 API key 和 custom:runapi provider。

### Recraft 處理是非同步還是同步的？

兩個 Recraft 端點都是非同步的。API 會立即回傳 task_id。輪詢任務狀態端點直到結果就緒。RunAPI SDK 和 CLI 會自動處理輪詢。

### Recraft 在 RunAPI 上的費用是多少？

Recraft 採用按任務計費 — 放大和去背按每張處理的圖片分別計價。請查看 RunAPI 定價頁面了解最新費率。無需訂閱或最低消費。


## Links

- [Hermes Agent 設定指南 →](https://runapi.ai/zh-TW/hermes-agent)
- [Recraft 模型 →](https://runapi.ai/zh-TW/models/recraft)
- [Model catalog](https://runapi.ai/zh-TW/models)
- [API docs](https://runapi.ai/zh-TW/docs)