שער LLM עם שכבת הנתונים בפנים

שישה נקודות קצה, לא אחת

כל מה שמתחת ל-/api/v1 הוא קריאת מודל, אבל סוג המודל קובע איזו נקודת קצה יכולה לענות — וכל אחת מחזירה פורמט משלה.

שלושת משטחי הצ'אט הם מימושים מקוריים, לא שכבת תרגום: כל אחד שולח אירועים בפרוטוקול שלו, כך שאתה מפרסר את הסטרים בדיוק כמו היום.

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

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

# discover before you call — free, reads the catalog
GET /api/v1/models   # every kind, with channels and rates
GET /api/v1/models/{model_id}  # one model, in detail
GET /api/v1/videos/models     # video_generation only
GET /api/v1/decisions/models  # decisions only

אפשר לסנן עם ?provider= לספק אחד, או ?exclude_video_and_decisions=true כדי להסתיר הכול חוץ מצ'אט ותמונה. להיות בקטלוג זה לא הבטחה: מודל וידאו לא עונה לבקשת צ'אט, וה-API מחזיר model_kind_mismatch.

מסלול ברירת מחדל, או כותרת לבחירת ספק

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

# first channel only — no automatic fallback
X-Felo-Channel: claude-cc
X-Felo-Channel: claude-cc,anthropic  # ordered selection, not a retry list

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

X-Felo-Channel עובד על שש נקודות היצירה שלמעלה. הוא לא חל על API הנתונים או על Felo APIs: הקריאות האלה הולכות לספק שאתה נוקב בו בבקשה.

מה באמת עולה קריאה

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

• מחירי קאש חלים רק כשתגובת הפרוטוקול מדווחת על שימוש בקאש; מודל שלא מדווח מחייב הכול במחיר הקלט.
• חיפוש ווב שהשירות של המודל מריץ ומדווח עליו עולה $0.01 לחיפוש.
• חלק מהמודלים מחויבים במדרגות לפי גודל הפרומפט: Claude Haiku 5.5 עולה $0.10 קלט ו-$0.50 פלט למיליון טוקנים עד פרומפט של 100K טוקנים, ומעל לזה $0.50 ו-$2.50 על הבקשה כולה.
• הטעינה הראשונה היא $1. בלי מנוי, בלי תשלום לכל משתמש, בלי התחייבות מינימלית — מפתח שלא בשימוש לא עולה כלום.

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

שני גבולות שנראים אותו דבר ולא

יתרה ריקה מחזירה 402 INSUFFICIENT_CREDITS. קריאות מהירות מדי מחזירות 429 RATE_LIMITED. המתנה פותרת את השני ומעולם לא את הראשון.

היום רק /v2/chat מתעד גבולות קשיחים. קריאות מודל יכולות להיות מוגבלות גם במעלה הזרם, וזה מופיע כ-429 — קראו X-RateLimit-* ו-Retry-After במקום לקבוע מספרים בקוד. כל תגובה נושאת request_id, והכותרת X-Request-Id שאתה שולח חוזרת כמו שהיא, כך שהלוגים שלך ושלנו מתיישרים.

תמונה ווידאו מסתיימות ברקע

שתי נקודות היצירה מחזירות task_id במקום תוצאה. שולחים, בודקים, אוספים — ושימו לב: אחרי שהמשימה נוצרה, רוב הכשלים מגיעים כ-200 עם סטטוס סופי, לא כשגיאת HTTP.

# submit, then poll the task
POST /api/v1/images/generations       → task_id
GET  /api/v1/images/generations/{id}  → status, result
POST /api/v1/videos/generations       → task_id
GET  /api/v1/videos/generations/{id}  → status, result

קראו את הסטטוס לפני התוצאה: failed ו-interrupted הם גם תשובות, ו-error.message מסביר למה. 402 בשליחה אומר שהמשימה מעולם לא נוצרה. SuperAgent עובד אחרת: הוא מחזיר stream_key ודוחף אירועים ב-SSE, אז אין מה לבדוק.

מחליפים את כתובת הבסיס ומשאירים את הלקוח

שני ה-SDK עובדים בלי שינוי ברגע שכתובת הבסיס מצביעה לכאן. npx feloapi-cli setup כותב את אותה תצורה ל-Claude Code ול-Codex.

# OpenAI SDK
base_url = "https://openapi.felo.ai/api/v1"

# Anthropic SDK — one level up; the SDK appends /v1/messages
base_url = "https://openapi.felo.ai/api"

# pin a provider (optional)
default_headers = {"X-Felo-Channel": "claude-cc"}

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

החצי ששער בדרך כלל משאיר לך

שער LLM מנתב קריאות מודל. כאן אותו מפתח מגיע גם לקטלוג של ⁦5,000+⁩ APIs — כך ששלב החיפוש של הסוכן שלך, השקפים שהוא מייצר והמסמך שהוא קורא שוב נגבים מאותם קרדיטים, לא מעוד שלושה ספקים.

• Search
• PPT Task
• SuperAgent
• Web Fetch
• X Search
• Mindmap
• Landing Page Task
• LiveDoc
• YouTube Subtitling

קריאות API נתונים הולכות לספקים בשם תחת /v1/beta — Tavily, Exa, Apollo ושאר הקטלוג — כל אחד לפי הבסיס המוצהר שלו.

שש שאלות על שער LLM