---
title: "透過 RunAPI 在 Hermes Agent 中使用 GPT — LLM API 指南"
url: "https://runapi.ai/zh-TW/hermes-gpt.md"
canonical: "https://runapi.ai/zh-TW/hermes-gpt"
locale: "zh-TW"
model: "gpt"
---

# 在 Hermes Agent 中使用 GPT。

GPT-5.5 是 OpenAI 的旗艦 LLM，透過 RunAPI 提供，每 token 價格僅為官方的一半。Hermes Agent 透過 custom:runapi 供應商以 chat_completions 模式連接——一個設定區塊即可解鎖所有 GPT 變體（5.5、5.4、5.4-mini、5.3-codex），支援串流、函式呼叫與結構化輸出。

## API example

```bash
curl -X POST https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "You are a concise coding assistant."},
      {"role": "user", "content": "Write a Python function that merges two sorted lists in O(n) time."}
    ],
    "temperature": 0.3,
    "max_tokens": 1024
  }'

```

### Response

```json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "def merge_sorted(a, b):\n    result = []\n    i = j = 0\n    while i < len(a) and j < len(b):\n        if a[i] <= b[j]:\n            result.append(a[i]); i += 1\n        else:\n            result.append(b[j]); j += 1\n    result.extend(a[i:])\n    result.extend(b[j:])\n    return result"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 38,
    "completion_tokens": 95,
    "total_tokens": 133
  }
}

```

## How it works

1. **將 RunAPI 加為自訂供應商** — 如果 custom:runapi 供應商已在 Hermes Agent 中設定，相同的 key 即可用於 GPT。否則，新增自訂供應商並設定 base_url 為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY，api_mode 設為 chat_completions。
2. **選擇 GPT 模型** — 將預設模型設為 gpt-5.5 使用旗艦版，gpt-5.4 或 gpt-5.4-mini 降低成本，或 gpt-5.3-codex 處理程式碼密集任務。/v1/chat/completions 端點回傳標準 OpenAI 回應，包含使用量統計與 finish_reason。
3. **使用串流或函式呼叫** — Hermes Agent 透過 custom:runapi 供應商轉發 stream、tools 與 response_format 參數。所有標準 OpenAI Chat Completions 參數均可透過 RunAPI 直接使用，無需修改。

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | 必填。gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.4-nano、gpt-5.3-codex 或 gpt-5.2。 |
| `messages` | `array` | 必填。訊息物件陣列，每個物件包含 role（system、user、assistant）與 content 欄位。 |
| `temperature` | `number` | 選填。取樣溫度，介於 0 到 2 之間。較低的值產生更具確定性的輸出。預設為 1。 |
| `max_tokens` | `integer` | 選填。completion 中生成的最大 token 數量。 |
| `stream` | `boolean` | 選填。設為 true 時，以 server-sent events 回傳增量 token 差異。預設為 false。 |
| `tools` | `array` | 選填。函式呼叫的工具定義陣列。每個工具包含 type、函式名稱、描述與參數 schema。 |
| `response_format` | `object` | 選填。將 type 設為 "json_object" 或 "json_schema" 以取得結構化 JSON 輸出。 |
| `reasoning_effort` | `string` | 選填。控制支援模型的思考深度。接受的值為 low、medium、high。 |

## FAQ

### 可以透過 RunAPI 在 Hermes Agent 中使用 GPT-5.5 嗎？

可以。Hermes Agent 支援自訂的相容 OpenAI 供應商。將 RunAPI 以 custom:runapi 加入，設定 base_url 為 https://runapi.ai/v1，key_env 設為 RUNAPI_API_KEY，api_mode 設為 chat_completions。將預設模型設為 gpt-5.5。

### RunAPI 的 GPT 定價與 OpenAI 官方定價相比如何？

RunAPI 對所有 GPT 模型收取 OpenAI 官方每 token 費率的 50%。此折扣適用於輸入與輸出 token。請查看 RunAPI 定價頁面以了解每百萬 token 的確切費率。

### 可以在不更改供應商設定的情況下切換 GPT 變體嗎？

可以。custom:runapi 供應商適用於所有 GPT 變體。只需更改請求中的 model 欄位——gpt-5.5、gpt-5.4、gpt-5.4-mini 或 gpt-5.3-codex。base URL、API key 與 api_mode 保持不變。

### Responses API 可以透過 RunAPI 在 Hermes Agent 中使用嗎？

可以。RunAPI 也在 /v1/responses 代理 OpenAI Responses API。如果 Hermes Agent 支援 Responses API 介面，將端點設為 https://runapi.ai/v1/responses。相同的 API key 與自訂供應商適用於兩個端點。

### 可以在 RunAPI 上使用 GPT 的函式呼叫與結構化輸出嗎？

可以。傳入 tools 陣列進行函式呼叫，或將 response_format 設為 json_schema 取得結構化輸出。RunAPI 將這些參數轉發給 GPT 模型，並以標準 OpenAI 回應格式回傳 tool_calls 或結構化 JSON。


## Links

- [Hermes Agent 設定指南 →](https://runapi.ai/zh-TW/hermes-agent)
- [GPT on RunAPI →](https://runapi.ai/zh-TW/models/gpt)
- [Model catalog](https://runapi.ai/zh-TW/models)
- [API docs](https://runapi.ai/zh-TW/docs)