Token Cafe × EchoBird 串接教學

推薦用 EchoBird 安裝與管理 Claude Code、Codex 等 Agent； 在 EchoBird 的模型中心填入 Token Cafe 的 OpenAI 地址與 Anthropic 地址，以及你的 sk-cafe- API Key，即可用台幣算力跑程式代理。

最後更新：2026-07-12

雙協議地址 建立 Token 安裝 EchoBird 模型中心設定 Claude / Codex 驗證

Token Cafe 雙協議地址（給 EchoBird 填）

EchoBird 模型中心通常會分別要求 OpenAI 與 Anthropic 兩組 endpoint。Token Cafe 兩邊都支援，但網址不一樣，請照下表填，不要混用。

OpenAI 相容地址

給 Codex、以及走 OpenAI Chat Completions 的 Agent 使用。

https://api.aciemind.com/v1

對應路徑：POST /v1/chat/completions、GET /v1/models

Anthropic 相容地址

給 Claude Code、以及走 Anthropic Messages 的 Agent 使用。

https://api.aciemind.com

對應路徑：POST /v1/messages（也接受 /messages）

API Keysk-cafe-...（OpenAI / Anthropic 兩欄可填同一把）
模型 ID見 模型目錄，例如 claude-haiku-4-5、gpt-5.4-mini、MiniMax-M3
計費請求成功後依公開模型定價記錄用量；付款與結算依帳號中心目前公告的服務方案
常見填錯： Anthropic 欄位若填成 .../v1，或 OpenAI 欄位漏掉 /v1，都可能連不上。 請嚴格：OpenAI = .../v1；Anthropic = https://api.aciemind.com（不要多加 /v1）。

第一步：建立 Token Cafe API Key

  1. 註冊／登入帳號中心

    開啟 account.aciemind.com，完成註冊或登入。新帳號可先取得限時體驗額度，確認 API 流程後再依付款政策選擇方案。

  2. 建立 API Token

    進入 Tokens →「新建 Token」→ 命名（例如 EchoBird）→ 建立。

    完整 sk-cafe-... 只顯示一次，請立刻複製保存。不要貼到公開聊天室、GitHub 或截圖。

  3. （建議）確認用量與帳務

    到帳號中心確認模型、用量、既有帳務額度與付款政策。新的預付額度目前暫停；既有額度不足時 API 可能回 402。

第二步：安裝 EchoBird

  1. 下載官方版本

    前往 echobird.ai，依系統下載 Windows / macOS / Linux。

    • GitHub Releases：頁面「獲取 EchoBird」連結
    • Windows 一鍵（官方提供時）：頁面安裝指令
    • macOS 首次開啟若被擋：依官方說明處理權限

  2. 安裝 Claude Code / Codex（在 EchoBird 內）

    開啟 EchoBird → 進入「應用管理」或類似 Agent 列表 → 一鍵安裝 Claude Code 與／或 Codex。缺什麼裝什麼即可。

EchoBird 負責安裝與啟動 Agent；Token Cafe 只負責模型 API 與計費。兩邊各做一件事，不要在終端機再手動改一堆設定檔（除非你有進階需求）。

第三步：在 EchoBird「模型中心」接入 Token Cafe

EchoBird 的 Model Nexus／模型中心是「一處配置、多處生效」：填好後，Claude Code、Codex 等會跟同一組供應商設定。

  1. 新增自訂供應商（或 API Router／自訂 endpoint）

    在模型中心選擇新增 OpenAI 相容 與 Anthropic 相容 供應商（介面名稱可能是 Custom / API Router / 自訂 endpoint，依版本略有差異）。

  2. 填入 OpenAI 設定

    Base URL / 地址https://api.aciemind.com/v1
    API Keysk-cafe-...
    協議OpenAI / Chat Completions
    測試模型建議先用較便宜模型，如 gpt-5.4-mini 或目錄上的 free／haiku 級

  3. 填入 Anthropic 設定

    Base URL / 地址https://api.aciemind.com
    API Key同一把 sk-cafe-...
    協議Anthropic Messages
    測試模型例如 claude-haiku-4-5（以 模型目錄 為準）

  4. 一鍵測速／測試連線

    若 EchoBird 提供「測速」或「測試」，對兩個供應商各測一次。成功後再指派給 Claude Code / Codex。

  5. 把 Agent 指到 Token Cafe 供應商

    在應用管理裡，將 Claude Code 的模型來源設為剛建的 Anthropic／Token Cafe；Codex 設為 OpenAI／Token Cafe。儲存後從 EchoBird 啟動 Agent。

第四步：用 Claude Code 或 Codex

  1. Claude Code

    在 EchoBird 啟動 Claude Code，確認目前模型為 Token Cafe 路由上的模型 ID。在專案目錄下下指令或對話，完成一次簡單問題（例如「列出目前目錄」）。

  2. Codex

    同樣從 EchoBird 啟動 Codex，確認走 OpenAI 相容供應商（Token Cafe）。送出一次短任務即可。

模型名稱必須是 Token Cafe 定價／路由裡已上架的 ID。若 EchoBird 預填了官方 claude-... 長名稱而本站沒有路由，請改成 模型目錄 上的短名稱。

第五步：驗證是否真的打到 Token Cafe

  1. 帳號中心看用量

    開啟 用量頁，應出現剛剛的呼叫紀錄與扣款。

  2. 用量有紀錄

    帳號中心 Usage 應出現剛剛的呼叫紀錄與成本（小額測試即可）。若完全沒紀錄，代表請求仍打到官方或其它供應商——回模型中心檢查 Base URL 與 Agent 綁定的供應商。

  3. 可選：curl 自測 Key

    # OpenAI 相容
curl https://api.aciemind.com/v1/models \
  -H "Authorization: Bearer sk-cafe-..."

# Anthropic 相容
curl https://api.aciemind.com/v1/messages \
  -H "x-api-key: sk-cafe-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{\"model\":\"claude-haiku-4-5\",\"max_tokens\":32,\"messages\":[{\"role\":\"user\",\"content\":\"ping\"}]}"

常見問題

為什麼要兩個地址？

OpenAI 生態與 Anthropic 生態的 HTTP 路徑與標頭不同。Token Cafe 同時提供兩種相容入口，EchoBird 也分開設定，才能讓 Codex 與 Claude Code 各自用對協議。

兩欄 API Key 可以一樣嗎？

可以。都填同一把 sk-cafe- 即可；請以帳號中心的 Usage、Transactions 與付款政策確認目前結算方式。

Anthropic 要不要加 /v1？

在 EchoBird 的 Anthropic Base URL 請填 https://api.aciemind.com。客戶端會自行請求 /v1/messages。若你填成 .../v1 反而容易變成錯誤路徑。

Cursor 呢？

Cursor 接自訂 API 常需付費方案。本教學主推 EchoBird + Claude Code / Codex，路徑較單純。

連得上但模型報錯？

先確認模型 ID 在 模型目錄 存在且路由已啟用；再查看 Usage 與既有帳務狀態。

相關連結