Felo API PlatformFelo API Platform

Kılavuzlar

Kanallar ve sağlayıcı yönlendirmesi

X-Felo-Channel ile bir modeli belirli bir sağlayıcıya sabitleyin ve varsayılan yönlendirme, fiyatlandırma ve fallback kurallarını öğrenin.

Bir model birden fazla upstream sağlayıcı aracılığıyla sunulabilir. Varsayılan olarak Felo sizin için bir sağlayıcı seçer. Belirli bir sağlayıcıya ihtiyaç duyduğunuzda, bir veya daha fazla genel kanal koduyla X-Felo-Channel istek başlığını gönderin.

Desteklenen endpoint'ler

X-Felo-Channel her Model API oluşturma endpoint'inde kabul edilir:

EndpointProtokol
POST /api/v1/chat/completionsOpenAI Chat Completions
POST /api/v1/responsesOpenAI Responses
POST /api/v1/messagesAnthropic Messages
POST /api/v1/images/generationsGörsel oluşturma
POST /api/v1/videos/generationsVideo oluşturma
POST /api/v1/decisionsKararlar

Data API (/v1/beta) veya Felo API'leri (/v2) için geçerli değildir.

Başlık değerleri

Değer, sıralı ve virgülle ayrılmış bir genel kanal kodları listesidir:

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

Genel Model API belirtiminden kurallar:

  • Varsayılan rotayı kullanmak için başlığı atlayın.
  • default yalnızca tek başına kullanıldığında geçerli bir değerdir. Kanal kodlarıyla birleştirmeyin.
  • Genel kanal kodları katalogdaki modelin channels[].code alanından gelir. Sağlayıcının görünen adını değil, kodu kullanın.
  • Yalnızca çalıştırılabilir, yayımlanmış kanallar yönlendirilebilir.

Varsayılan yönlendirme

Başlığı atladığınızda veya default değerini tek başına gönderdiğinizde sağlayıcıyı platform seçer. Cüzdan modunda modelin geçerli genel kanal sırasını tersten tarar, yayımlanmamış veya kullanılamayan kanalları atlar ve ilk kullanılabilir kanalın sağlayıcısını seçer. Aynı upstream model kimliğine ve hizmet katmanına sahip o sağlayıcının kullanılabilir endpoint'lerini içerebilir.

X-Felo-Channel: default göndermeniz gerekmez; başlığı atlamak varsayılan rotayı kullanmanın normal yoludur.

Açık yönlendirme

Kanal kodları gönderdiğinizde, listelediğiniz sırayla doğrulanır. Yalnızca ilk kanalın sağlayıcı grubu gönderilir. Başka bir sağlayıcıya otomatik geri dönüş yoktur.

Bu, bir kanal listesinin bir yeniden deneme ilkesi değil, bir seçim olduğu anlamına gelir. Yük devretmeye ihtiyacınız varsa bunu uygulamanızda uygulayın: ilki başarısız olduktan sonra farklı bir kanalla yeni bir istek gönderin.

Eski sağlayıcı başlıkları X-Felo-Channel başlığını geçersiz kılamaz. İstemcinizdeki başka bir başlık da bir sağlayıcı istiyorsa X-Felo-Channel önceliklidir.

Fiyatlandırma

Her genel kanal kendi standart ücretlerini ve indirim çarpanını yayımlar. Model ayrıntı sayfasında bir sağlayıcı için gösterilen fiyat, o kanalın müşteri fiyatıdır. Sabitlediğiniz kanal, hangi sağlayıcının ücretinin geçerli olacağını belirler.

Yüksek hacimli bir iş yükü için bir kanalı sabitlemeden önce model sayfasındaki sağlayıcı satırlarını karşılaştırın ve Modeller ve Fiyatlar bölümünü okuyun.

Kanal kodu bulma

  1. Model ayrıntı sayfasını açın ve sağlayıcı tablosunu bulun.
  2. Sağlayıcıyı genel kanal koduyla eşleştirin. Kod, API tarafından kullanılan istikrarlı tanımlayıcıdır.
  3. Kataloğu doğrudan okuyorsanız channels[].code kullanın ve runnable alanını kontrol edin.

Örneğin, claude-haiku-5-5 aralarında anthropic (varsayılan), azure, google-vertex-global ve claude-cc bulunan birkaç kanal yayımlar. claude-cc satırı kendi indirimini gösterir, bu nedenle onu sabitlemek hem sağlayıcıyı hem de ücreti değiştirir.

Örnekler

Tek bir kanala sabitlenmiş 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."}]
  }'

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

Yönlendirme başlığı olmadan varsayılan yönlendirme:

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

İlgili