מדריכים

פרוטוקולים ו-SDKs

השתמשו בפרוטוקולים תואמי OpenAI, Responses ו-Anthropic Messages, כולל סטרימינג, קריאות לכלים והגירה.

ה-Model API מדבר בשלושה פרוטוקולי תקשורת. השאירו את ה-SDK הקיים שלכם ושנו את כתובת הבסיס, מפתח ה-API ומזהה המודל.

מטריצת נקודות קצה

פרוטוקול	Endpoint	לקוח טיפוסי
OpenAI Chat Completions	`POST https://openapi.felo.ai/api/v1/chat/completions`	OpenAI SDK, רוב הכלים התואמים ל-OpenAI
OpenAI Responses	`POST https://openapi.felo.ai/api/v1/responses`	OpenAI SDK עם יכולות Responses API
Anthropic Messages	`POST https://openapi.felo.ai/api/v1/messages`	Anthropic SDK, Claude Code, כלים ילידיים ל-Claude

כתובות בסיס

לקוח	כתובת בסיס	למה
OpenAI SDK	`https://openapi.felo.ai/api/v1`	ה-SDK מוסיף `/chat/completions` או `/responses`
Anthropic SDK	`https://openapi.felo.ai/api`	ה-SDK מוסיף `/v1/messages`; אל תוסיפו `/v1` בעצמכם

שני הלקוחות משתמשים במפתח ה-API של Felo כמפתח ה-API של ה-SDK.

import OpenAI from "openai";
import Anthropic from "@anthropic-ai/sdk";

const openai = new OpenAI({
  apiKey: process.env.FELO_API_KEY,
  baseURL: "https://openapi.felo.ai/api/v1",
});

const anthropic = new Anthropic({
  apiKey: process.env.FELO_API_KEY,
  baseURL: "https://openapi.felo.ai/api",
});

בחירת פרוטוקול

השתמשו ב-Chat Completions כשהכלי או ה-SDK שלכם מצפים למערך messages המוכר ול-choices[0].message.content.
השתמשו ב-Responses כשאתם צריכים את אובייקט Responses של OpenAI, input, instructions או output_text.
השתמשו ב-Messages כשאתם משתמשים ב-Anthropic SDK או בכלי ילידי ל-Claude.

בדקו את המודל לפני שאתם מניחים שכל פרוטוקול עובד. הקטלוג חושף supported_protocols, supported_parameters ו-recommended_protocol. recommended_protocol הוא המלצה ללקוח, לא הגבלה; מודל עשוי עדיין לקבל פרוטוקול אחר.

סטרימינג

הגדירו stream: true כדי לקבל Server-Sent Events.

Chat Completions פולט נתחי שיחה בסגנון OpenAI.
Responses פולט אירועי SSE של Responses ומסתיים באובייקט תגובה שהושלם.
Messages פולט אירועי זרם הודעות של Anthropic.

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

קריאות לכלים ופלט מובנה

העבירו tools במבנה שהפרוטוקול מגדיר. התמיכה משתנה בין מודלים, לכן בדקו את supported_parameters בקטלוג לפני שאתם מסתמכים על קריאות לכלים, מצב JSON או פלט מובנה. מודל יכול לקבל את השדה ועדיין להתעלם מאפשרות לא נתמכת.

ניתוב ערוצים

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

מעבר מ-API רשמי

שנו את כתובת הבסיס לכתובת Felo המתאימה.
החליפו את מפתח ה-API ב-FELO_API_KEY.
החליפו את שם המודל במזהה המודל הציבורי של Felo.
השאירו את שאר צורת הבקשה.

תסמין	סיבה סבירה
404 בכל בקשה	כתובת הבסיס כבר כוללת `/v1`, או שנוסף `/v1` ידנית לכתובת הבסיס של Anthropic
401	מפתח Felo חסר או שהלקוח עדיין שולח את המפתח הישן
שגיאת `model` מסוג 400	מזהה המודל אינו ציבורי או אינו תומך בנקודת הקצה שנבחרה
בקשת Messages נדחית	`max_tokens` נדרש בפרוטוקול Messages
קריאה לכלי מתעלמת	המודל אינו מפרסם את היכולת הזו