Felo API PlatformFelo API Platform

指南

通道與供應商路由

用 X-Felo-Channel 把模型固定到指定供應商，並理解預設路由、計費和 fallback 規則。

同一個模型可能由多個上游供應商提供。預設情況下，Felo 會替你選擇供應商。當你需要指定供應商時，請在請求中帶上 X-Felo-Channel 標頭，值為一或多個公開通道代碼。

支援的 endpoints

X-Felo-Channel 在每個 Model API 生成 endpoint 上都能使用：

Endpoint協議
POST /api/v1/chat/completionsOpenAI Chat Completions
POST /api/v1/responsesOpenAI Responses
POST /api/v1/messagesAnthropic Messages
POST /api/v1/images/generations圖像生成
POST /api/v1/videos/generations影片生成
POST /api/v1/decisions決策

它不適用於 Data API（/v1/beta）或 Felo APIs（/v2）。

標頭值

值是一份有序、以逗號分隔的公開通道代碼清單：

X-Felo-Channel: claude-cc
X-Felo-Channel: claude-cc,anthropic
X-Felo-Channel: default

公開 Model API 規格的規則：

  • 省略標頭即使用預設路由。
  • default 只有單獨使用時才是有效值。不要把它與通道代碼混用。
  • 公開通道代碼來自目錄中模型的 channels[].code 欄位。請用代碼，不是供應商顯示名稱。
  • 只有可執行且已公布的通道可被路由。

預設路由

當你省略標頭，或單獨送出 default 時，平台會選擇供應商。在 wallet 模式下，它會反向掃描模型有效的公開通道順序，略過未公布或不可用的通道，並選擇第一個可用通道的供應商。它可能納入該供應商旗下、具有相同上游模型 ID 與 service tier 的可用 endpoints。

你不需要送出 X-Felo-Channel: default；省略標頭才是使用預設路由的正常方式。

明確路由

當你送出通道代碼時，平台會依你列出的順序驗證。只有第一個通道的供應商群組會被提交。不會自動切換到其他供應商。

也就是說，通道清單是一種選擇，不是重試策略。若需要容錯切換，請在應用程式中實作：第一個通道失敗後，用不同的通道重新送出請求。

舊版供應商標頭無法覆寫 X-Felo-Channel。若用戶端中還有其他標頭也要求指定供應商，以 X-Felo-Channel 為準。

價格

每個公開通道各自公布標準費率與折扣乘數。模型詳情頁上顯示的供應商價格，就是該通道的客戶價格。你固定的通道決定套用哪個供應商的費率。

在為高流量工作負載固定通道之前，請先比較模型頁面上的供應商列，並閱讀模型與價格。

尋找通道代碼

  1. 開啟模型詳情頁，找到供應商表。
  2. 將供應商對應到它的公開通道代碼。代碼是 API 使用的穩定識別碼。
  3. 若你直接讀取目錄，請使用 channels[].code 並檢查 runnable。

例如，claude-haiku-5-5 公布了多個通道，包括 anthropic（預設）、azure、google-vertex-global 與 claude-cc。claude-cc 那一列顯示自己的折扣，因此固定它會同時改變供應商與費率。

範例

將 Chat Completions 固定到單一通道：

curl https://openapi.felo.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Felo-Channel: claude-cc" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

使用同一通道的 Anthropic Messages：

curl https://openapi.felo.ai/api/v1/messages \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Felo-Channel: claude-cc" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

預設路由，不帶路由標頭：

curl https://openapi.felo.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Summarize this change in one sentence."}]
  }'

相關