Felo API PlatformFelo API Platform

Průvodci

Kanály a směrování poskytovatelů

Připněte model ke konkrétnímu poskytovateli hlavičkou X-Felo-Channel a poznejte výchozí směrování, ceny a pravidla fallbacku.

Model může být obsluhován několika upstreamovými poskytovateli. Ve výchozím nastavení Felo vybere poskytovatele za vás. Když potřebujete konkrétního poskytovatele, odešlete hlavičku požadavku X-Felo-Channel s jedním nebo více kódy veřejných kanálů.

Podporované endpointy

X-Felo-Channel je přijímán na každém generovacím endpointu Model API:

EndpointProtokol
POST /api/v1/chat/completionsOpenAI Chat Completions
POST /api/v1/responsesOpenAI Responses
POST /api/v1/messagesAnthropic Messages
POST /api/v1/images/generationsGenerování obrázků
POST /api/v1/videos/generationsGenerování videa
POST /api/v1/decisionsDecisions

Nevztahuje se na Data API (/v1/beta) ani na Felo API (/v2).

Hodnoty hlavičky

Hodnota je uspořádaný seznam kódů veřejných kanálů oddělených čárkami:

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

Pravidla z veřejné specifikace Model API:

  • Vynechejte hlavičku, chcete-li použít výchozí trasu.
  • default je platná hodnota pouze tehdy, když je použita samostatně. Nekombinujte ji s kódy kanálů.
  • Kódy veřejných kanálů pocházejí z pole channels[].code modelu v katalogu. Použijte kód, nikoli zobrazovaný název poskytovatele.
  • Směrovatelné jsou pouze spustitelné, publikované kanály.

Výchozí směrování

Když hlavičku vynecháte nebo odešlete samotné default, platforma vybere poskytovatele. V režimu peněženky prochází efektivní veřejné pořadí kanálů modelu v opačném směru, přeskakuje nepublikované nebo nedostupné kanály a vybere poskytovatele prvního dostupného kanálu. Může zahrnout dostupné endpointy od tohoto poskytovatele se stejným upstreamovým ID modelu a úrovní služby.

Nemusíte odesílat X-Felo-Channel: default; vynechání hlavičky je obvyklý způsob použití výchozí trasy.

Explicitní směrování

Když odešlete kódy kanálů, jsou ověřeny v pořadí, v jakém je uvedete. Odešle se pouze skupina poskytovatele prvního kanálu. Neexistuje automatický přechod na jiného poskytovatele.

To znamená, že seznam kanálů je výběr, nikoli zásada opakování. Pokud potřebujete failover, implementujte jej ve své aplikaci: po selhání prvního kanálu odešlete nový požadavek s jiným kanálem.

Starší hlavičky poskytovatelů nemohou přepsat X-Felo-Channel. Pokud jiná hlavička ve vašem klientovi také žádá o poskytovatele, X-Felo-Channel má přednost.

Ceny

Každý veřejný kanál publikuje své vlastní standardní sazby a násobitel slevy. Cena zobrazená u poskytovatele na stránce detailu modelu je cenou pro zákazníka daného kanálu. Kanál, který připnete, určuje poskytovatele, jehož sazba se použije.

Před připnutím kanálu pro zátěž s velkým objemem porovnejte řádky poskytovatelů na stránce modelu a přečtěte si Modely a ceny.

Najděte kód kanálu

  1. Otevřete stránku detailu modelu a najděte tabulku poskytovatelů.
  2. Přiřaďte poskytovatele k jeho kódu veřejného kanálu. Kód je stabilní identifikátor používaný API.
  3. Pokud čtete katalog přímo, použijte channels[].code a zkontrolujte runnable.

Například claude-haiku-5-5 publikuje několik kanálů, včetně anthropic (výchozí), azure, google-vertex-global a claude-cc. Řádek claude-cc zobrazuje vlastní slevu, takže jeho připnutí změní poskytovatele i sazbu.

Příklady

Chat Completions připnuté k jednomu kanálu:

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 se stejným kanálem:

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."}]
  }'

Výchozí směrování bez hlavičky směrování:

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."}]
  }'

Související