Gate.AI 文件

快速開始

1. 建立 API 密鑰

1. 前往 gate.ai，選擇登入模式，授權登入
2. 進入控制台 → 進入設定 → 進入 API 密鑰 → 建立密鑰

2. 自動路由（選用）

自動路由預設開啟，控制方式：

進入控制台 → 進入設定 → 進入路由 → 自動路由開關

啟用後，Gate.AI 會自動為每個請求選擇最佳模型。若你偏好自行選擇模型，可略過此步驟，直接指定模型（如 anthropic/claude-sonnet-4.6）。

標準接入

與 OpenAI API 完全相容，支援 Python、Node.js、curl 等生態工具。

替換 Base URL ( https://api.gate.ai/openai/v1 )與 API 密鑰即可使用。

from openai import OpenAI

client = OpenAI(
    api_key="GATEAI_API_KEY",  # get GATEAI_API_KEY from gate.ai (API Key)
    base_url="https://api.gate.ai/openai/v1",
)

completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)

# get the response from LLM (role=assistant)
print(completion.choices[0].message.content)

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Hello! Nice to meet you. How can I help you?"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

Cursor 接入

Claude Code 接入

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"
claude

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gaterouter.ai/anthropic",
    "ANTHROPIC_API_KEY": "sk-or-v1-xxxxxxxxxxxxxxxx"
  }
}

env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"

export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

export ANTHROPIC_CUSTOM_MODEL_OPTION="anthropic/claude-sonnet-4.6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet（Gate.AI）"

claude

Claude Desktop 接入

Hermes 接入

前置條件

• 已在 Gate.AI 控制台 建立 API 金鑰。
• 若使用自動路由，請在控制台 設定 → 路由 中開啟 自動路由。

方式一：終端機設定

1. 選擇模型與自訂端點

在終端機執行：

hermes model

在選單中選擇 Custom endpoint，依提示填寫：

若詢問 context length（上下文長度），直接按 Enter 留空即可（由 Hermes 自動偵測）。

2.（選用）本機 Web 管理介面

若希望以瀏覽器編輯設定，可執行：

hermes dashboard

3. 驗證

hermes chat "Hello"

成功表示請求已到達 Gate.AI，並由智能路由或你指定的模型回傳結果。

也可執行 hermes doctor 驗證是否連線成功。

方式二：直接編輯設定檔

1. 檔案位置

macOS / Linux

• ~/.hermes/config.yaml，主要設定（模型、provider、base_url、api_key 等）
• ~/.hermes/.env，金鑰與敏感環境變數（建議）

Windows

• C:\Users\<使用者名稱>\.hermes\config.yaml
• C:\Users\<使用者名稱>\.hermes\.env

2. 在 .env 中儲存金鑰（擇一）

寫法 A（與 Gate.AI 命名一致）

# Gate.AI API 密钥
GATEAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

寫法 B（與 Hermes 自訂端點常見約定一致）

Hermes 對自訂端點在未單獨設定 model.api_key 時，會退回使用 OPENAI_API_KEY。可將 Gate.AI 金鑰寫入：

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

3. 在 config.yaml 中設定 model

自動路由（auto）

model:
  default: auto
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

若使用 寫法 B，可將 api_key 留空或刪除該欄位，讓 Hermes 使用 OPENAI_API_KEY。

Hermes 會在載入設定時展開 ${VAR}（變數須已存在於環境中，通常由 ~/.hermes/.env 注入）。

固定模型範例

模型 ID 須與 Gate.AI 模型列表 一致）：

model:
  default: deepseek/deepseek-v3.2
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

4. 儲存後驗證

儲存後用 hermes chat "Hello" 測試 Gate.AI 連線來驗證。

多線路 / 多模型

若同一組 Gate.AI 金鑰下需要 多條邏輯線路（例如一條用 auto、一條固定 deepseek/deepseek-v3.2），可在 config.yaml 中設定 custom_providers（名稱僅允許字母、數字、連字號等；建議用連字號，例如 gateai-auto）：

model:
  default: auto
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

custom_providers:
  - name: gateai-auto
    base_url: https://api.gate.ai/openai/v1
    api_key: ${GATEAI_API_KEY}
    model: auto

  - name: gateai-deepseek
    base_url: https://api.gate.ai/openai/v1
    api_key: ${GATEAI_API_KEY}
    model: deepseek/deepseek-v3.2

切換方式

1. 終端機：再次執行 hermes model，在選單中選擇對應命名線路或 Custom endpoint。
2. 對話中（TUI）：使用 Hermes 官方文件中的 /model 語法，例如：

/model custom:gateai-auto:auto
/model custom:gateai-deepseek:deepseek/deepseek-v3.2

（實際名稱以 custom_providers[].name 為準；三段為 custom:<設定名>:<模型 id>。）

常見問題

QClaw 接入

若您已安裝 QClaw，請依下列步驟接入 Gate.AI。

對話式完成設定

1. 在對話中輸入以下內容，請將 apiKey 替換為您的 Gate.AI API 密鑰：

幫我新增一個 provider
名稱：Gate.AI
apiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.gate.ai/openai/v1
模型：auto

QClaw 會自動新增成功並重新啟動後生效。

2. 驗證是否成功

直接輸入：「幫我驗證一下 Gate.AI 設定有沒有生效」。對話應回覆「Gate.AI provider 已成功新增！」（實際文案以介面為準。）

3. 切換到 Gate.AI 使用

直接輸入：「切換到 Gate.AI 下面的 auto」。對話應回覆「已切換成功！」（實際文案以介面為準。）

AutoClaw 接入

1. 設定入口

點選左下角偏好設定，選擇模型與 API，再點選新增自訂模型。

2. 新增模型

• 服務商選擇自訂。
• 新增 Gate.AI 支援的模型 ID，例如 deepseek/deepseek-v3.2。
• 填寫顯示名稱，例如：Gate.AI(deepseek-v3.2)。
• 填寫 API Key，例如：sk-or-v1-xxxxxxxxxxxxxxxx。
• 填寫 Base URL：https://api.gate.ai/openai/v1

3. 測試設定是否成功

點選連通測試，若顯示「測試成功」，表示設定成功。

4. 使用模型

• 點選新增按鈕，儲存成功後返回應用程式。
• 在聊天框下方切換模型，選擇已設定的 Gate.AI(deepseek-v3.2)，即可使用。

API 參考

{
  "model": "bytedance/seedance-2.0",
  "prompt": "A golden retriever running on a sunny beach, cinematic camera movement",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": false,
  "seed": -1,
  "metadata": {
    "source": "playground"
  },
  "webhook_url": "https://example.com/webhooks/gateai-video"
}

{
  "code": 200,
  "msg": "",
  "data": {
    "job_id": "video_abc123",
    "status": "in_progress",
    "model": "bytedance/seedance-2.0",
    "status_url": "https://api.gate.ai/api/v1/videos/video_abc123",
    "message": "视频任务已提交，请调用 status_url 查询生成进度。",
    "current_balance": "100.0000000000",
    "estimated_cost": "1.0800000000",
    "pre_deduct_amount": "1.0800000000",
    "balance_after_estimate": "98.9200000000",
    "currency": "USDT",
    "billing_notice": "视频生成完成后按实际任务结果扣款，提交后请保持余额充足。"
  }
}

{
  "code": 200,
  "msg": "",
  "data": {
    "job_id": "video_abc123",
    "status": "completed",
    "model": "bytedance/seedance-2.0",
    "status_url": "https://api.gate.ai/api/v1/videos/video_abc123",
    "download_url": "https://api.gate.ai/api/v1/videos/video_abc123/content",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "estimated_cost": "1.0800000000",
    "billed_cost": "1.0800000000",
    "billing_status": "settled",
    "expires_at": "2026-06-26T05:00:00Z",
    "created_at": "2026-05-27T05:00:00Z",
    "completed_at": "2026-05-27T05:03:00Z"
  }
}

HTTP/1.1 302 Found
Location: https://cdn.example.com/videos/video_abc123.mp4?expires=1780000000

模型

模型 ID 格式：provider/model-name。版本號使用 .（如 4.6），而非 -。

更多模型可前往模型頁面查看

故障排除

# ❌ 錯誤
https://api.gate.ai/v1/chat/completions

# ✅ 正確
https://api.gate.ai/openai/v1/chat/completions  # openai 協議
https://api.gate.ai/anthropic/v1/messages  # anthropic 協議

// ❌ 部分模型不支援
{ "model": "gpt-4o", "max_tokens": 100 }

// ✅ 使用 max_completion_tokens
{ "model": "openai/gpt-5.5", "max_completion_tokens": 100 }

# ✅ 正確的請求標頭
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx # openai 協議
X-api-key: sk-xxxxxxxxxxxxxxxxxxxx # anthropic 協議