מדריכים

ערוצים וניתוב ספקים

נעלו מודל לספק מסוים באמצעות X-Felo-Channel, והבינו ניתוב ברירת מחדל, תמחור וגיבוי.

מודל יכול להיות מוגש דרך כמה ספקים חיצוניים. כברירת מחדל, Felo בוחרת ספק בשבילכם. כשאתם צריכים ספק מסוים, שלחו את כותרת הבקשה X-Felo-Channel עם קוד ערוץ ציבורי אחד או יותר.

נקודות קצה נתמכות

X-Felo-Channel מתקבל בכל נקודת קצה של יצירה ב-Model API:

Endpoint	פרוטוקול
`POST /api/v1/chat/completions`	OpenAI Chat Completions
`POST /api/v1/responses`	OpenAI Responses
`POST /api/v1/messages`	Anthropic Messages
`POST /api/v1/images/generations`	יצירת תמונות
`POST /api/v1/videos/generations`	יצירת וידאו
`POST /api/v1/decisions`	החלטות

הוא אינו חל על Data API (/v1/beta) או על ממשקי Felo (/v2).

ערכי הכותרת

הערך הוא רשימה מסודרת, מופרדת בפסיקים, של קודי ערוץ ציבוריים:

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

כללים ממפרט ה-Model API הציבורי:

השמיטו את הכותרת כדי להשתמש במסלול ברירת המחדל.
default הוא ערך חוקי רק כשהוא מופיע לבדו. אל תשלבו אותו עם קודי ערוצים.
קודי ערוץ ציבוריים מגיעים משדה channels[].code של המודל בקטלוג. השתמשו בקוד, לא בשם התצוגה של הספק.
רק ערוצים פועלים ומפורסמים ניתנים לניתוב.

ניתוב ברירת מחדל

כשאתם משמיטים את הכותרת, או שולחים default לבדו, הפלטפורמה בוחרת את הספק. במצב ארנק היא סורקת את סדר הערוצים הציבוריים האפקטיבי של המודל מהסוף להתחלה, מדלגת על ערוצים לא מפורסמים או לא זמינים, ובוחרת את הספק של הערוץ הזמין הראשון. היא עשויה לכלול נקודות קצה זמינות מאותו ספק עם אותו מזהה מודל חיצוני ואותה דרגת שירות.

אין צורך לשלוח X-Felo-Channel: default; השמטת הכותרת היא הדרך הרגילה להשתמש במסלול ברירת המחדל.

ניתוב מפורש

כשאתם שולחים קודי ערוצים, הם מאומתים לפי הסדר שבו רשמתם אותם. רק קבוצת הספק של הערוץ הראשון נשלחת. אין נפילה אוטומטית לספק אחר.

כלומר, רשימת ערוצים היא בחירה, לא מדיניות ניסיונות חוזרים. אם אתם צריכים failover, הטמיעו אותו באפליקציה שלכם: שלחו בקשה חדשה עם ערוץ אחר לאחר שהראשון נכשל.

כותרות ספק מדור קודם אינן יכולות לעקוף את X-Felo-Channel. אם כותרת אחרת בלקוח שלכם גם מבקשת ספק, X-Felo-Channel גובר.

תמחור

כל ערוץ ציבורי מפרסם תעריפים סטנדרטיים ומכפיל הנחה משלו. המחיר שמוצג עבור ספק בעמוד פרטי המודל הוא מחיר הלקוח של אותו ערוץ. הערוץ שאתם מצמידים קובע איזה ספק תעריף שלו יחול.

לפני נעיצת ערוץ לעומס עבודה בנפח גבוה, השוו את שורות הספקים בעמוד המודל וקראו את מודלים ותמחור.

מציאת קוד ערוץ

פתחו את עמוד פרטי המודל ומצאו את טבלת הספקים.
התאימו את הספק לקוד הערוץ הציבורי שלו. הקוד הוא המזהה היציב שמשתמש בו ה-API.
אם אתם קוראים את הקטלוג ישירות, השתמשו ב-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."}]
  }'