Felo API PlatformFelo API Platform

Panduan

Saluran dan penghalaan penyedia

Kunci model kepada penyedia tertentu dengan X-Felo-Channel dan fahami penghalaan lalai, penetapan harga serta fallback.

Sesuatu model boleh dilayani melalui beberapa penyedia huluan. Secara lalai, Felo memilih penyedia untuk anda. Apabila anda memerlukan pembekal tertentu, hantar pengepala permintaan X-Felo-Channel dengan satu atau lebih kod saluran awam.

Endpoint yang disokong

X-Felo-Channel diterima pada setiap endpoint penjanaan Model API:

EndpointProtokol
POST /api/v1/chat/completionsOpenAI Chat Completions
POST /api/v1/responsesOpenAI Responses
POST /api/v1/messagesAnthropic Messages
POST /api/v1/images/generationsPenjanaan imej
POST /api/v1/videos/generationsPenjanaan video
POST /api/v1/decisionsKeputusan

Ia tidak terpakai pada Data API (/v1/beta) atau Felo APIs (/v2).

Nilai pengepala

Nilai ialah senarai kod saluran awam yang tersusun dan dipisahkan dengan koma:

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

Peraturan daripada spesifikasi Model API awam:

  • Tinggalkan pengepala untuk menggunakan laluan lalai.
  • default ialah nilai sah hanya apabila digunakan bersendirian. Jangan gabungkannya dengan kod saluran.
  • Kod saluran awam datang daripada medan channels[].code model dalam katalog. Gunakan kod, bukan nama paparan pembekal.
  • Hanya saluran yang boleh dijalankan dan diterbitkan boleh dihalakan.

Penghalaan lalai

Apabila anda meninggalkan pengepala, atau menghantar default bersendirian, platform memilih penyedia. Dalam mod wallet, ia mengimbas susunan saluran awam berkesan model secara terbalik, melangkau saluran yang tidak diterbitkan atau tidak tersedia, dan memilih penyedia saluran pertama yang tersedia. Ia mungkin menyertakan endpoint tersedia daripada penyedia tersebut dengan ID model huluan dan tahap perkhidmatan yang sama.

Anda tidak perlu menghantar X-Felo-Channel: default; meninggalkan pengepala ialah cara biasa untuk menggunakan laluan lalai.

Penghalaan eksplisit

Apabila anda menghantar kod saluran, kod tersebut disahkan mengikut susunan yang anda senaraikan. Hanya kumpulan penyedia saluran pertama dihantar. Tiada sandaran automatik kepada penyedia lain.

Ini bermakna senarai saluran ialah pemilihan, bukan dasar cubaan semula. Jika anda memerlukan failover, laksanakannya dalam aplikasi anda: hantar permintaan baharu dengan saluran berbeza selepas yang pertama gagal.

Pengepala penyedia legasi tidak boleh menggantikan X-Felo-Channel. Jika pengepala lain dalam klien anda juga meminta penyedia, X-Felo-Channel diutamakan.

Harga

Setiap saluran awam menerbitkan kadar standard dan pendarab diskaunnya sendiri. Harga yang dipaparkan untuk pembekal pada halaman butiran model ialah harga pelanggan saluran tersebut. Saluran yang anda tetapkan menentukan penyedia yang kadarnya terpakai.

Sebelum menetapkan saluran untuk beban kerja berjumlah besar, bandingkan baris pembekal pada halaman model dan baca Model dan Harga.

Cari kod saluran

  1. Buka halaman butiran model dan cari jadual pembekal.
  2. Padankan pembekal dengan kod saluran awamnya. Kod ialah pengecam stabil yang digunakan oleh API.
  3. Jika anda membaca katalog secara terus, gunakan channels[].code dan semak runnable.

Sebagai contoh, claude-haiku-5-5 menerbitkan beberapa saluran, termasuk anthropic (lalai), azure, google-vertex-global, dan claude-cc. Baris claude-cc menunjukkan diskaunnya sendiri, jadi menetapkannya mengubah kedua-dua penyedia dan kadar.

Contoh

Chat Completions ditetapkan kepada satu saluran:

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 dengan saluran yang sama:

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

Penghalaan lalai, tanpa pengepala penghalaan:

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

Berkaitan