Felo API PlatformFelo API Platform

AI 工具設定

Magpie

把 Magpie 設定為 Felo API Platform 的模型入口,讓本機閘道向 Codex、Claude Code 等 agent 提供 Felo 模型。

如果你正在使用 Magpie(把各個程式設計 Agent 指向同一份模型清單的選單列應用程式與本機閘道),並希望這份清單包含 Felo API Platform 的模型,請使用本指南。Magpie 在 127.0.0.1:3425 上執行閘道,並改寫每個 Agent 的設定讓它指向閘道,因此 Agent 端不需要持有 Felo key 或 Felo 位址。

開始之前

你需要一個 Felo API Platform key。同一個 key 可用於模型協定、Agent 用戶端、Search、Web Fetch、PPT、Mindmap、LiveDocs、X Search、YouTube Subtitling、Landing Page 和 SuperAgent API。

export FELO_API_KEY="YOUR_API_KEY"

如果還沒安裝 Magpie:

curl -fsSL https://usemagpie.ai/install.sh | sh

新增 Felo 作為 provider

Felo 用一個 key 同時提供 Chat Completions、Responses 和 Anthropic Messages。把 Magpie 能用到的 base 都填上:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

在應用程式介面裡,Providers → Add provider 填的是同一組資訊:名稱 felo、key,以及 OpenAI-compatible base https://openapi.felo.ai/api/v1;如果選 Anthropic-compatible provider,base 使用 https://openapi.felo.ai/api。

存好 key 後,Magpie 會向 Felo 取得模型清單;這些模型會以 felo/<model-id> 的形式出現在每個 Agent 的選擇器裡。

magpie provider models felo   # 重新取得 Felo 的模型清單
magpie models                 # Agent 可選的模型,含 felo/<model>

在 Agent 裡選用 Felo 模型

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

也可以在 Agents 頁面直接選。因為 Felo 同時支援三種協定,每個 Agent 都能維持自己的原生協定——Claude Code 繼續走 Anthropic Messages,Codex 繼續走 Responses——最後都落到 Felo。

用戶端欄位

欄位值
Provider 名稱 / idfelo
OpenAI Chat Completions basehttps://openapi.felo.ai/api/v1
OpenAI Responses basehttps://openapi.felo.ai/api/v1
Anthropic Messages basehttps://openapi.felo.ai/api
API key你的 FELO_API_KEY
模型felo/claude-sonnet-5-5

驗證設定

magpie provider test felo

Magpie 會依每種協定各送出一個小請求並回報延遲。接著用選了 felo/ 模型的 Agent 問一個簡短問題;能收到回覆,就代表 Agent → Magpie 閘道 → Felo 整條鏈路已經通了。

疑難排解

問題檢查什麼
felo 底下沒有模型先確認 key 有效,再執行 magpie provider models felo 取得清單
出現 Model not found模型名稱要和 magpie models 印出的完全一致,形如 felo/<model-id>
認證失敗用 magpie provider key felo <key> 重新填入 key
Anthropic 呼叫失敗base 必須是 https://openapi.felo.ai/api,不帶 /v1
Codex 不認這個模型重新啟動 Codex;它在啟動時讀取模型清單

下一步