البروتوكولات وSDK

يتحدث Model API ثلاثة بروتوكولات نقل. أبقِ SDK الحالية لديك وغيّر عنوان URL الأساسي ومفتاح API ومعرّف النموذج.

مصفوفة endpoints

عناوين URL الأساسية

يستخدم العميلان مفتاح Felo API الخاص بك كمفتاح 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 أو المخرجات المنظّمة. قد يقبل النموذج الحقل ويتجاهل خيارًا غير مدعوم.

توجيه القنوات

تقبل endpoints الثلاثة جميعها X-Felo-Channel عندما تحتاج إلى تثبيت مزوّد. راجع القنوات وتوجيه المزوّد لقواعد الرأس والأمثلة.

الانتقال من API رسمي

1. غيّر عنوان URL الأساسي إلى عنوان Felo المطابق.
2. استبدل مفتاح API بـFELO_API_KEY.
3. استبدل اسم النموذج بمعرّف نموذج Felo العام.
4. أبقِ بقية شكل الطلب.

ذو صلة

• مرجع Model API
• النماذج والتسعير
• دليل LLM API
• إعداد أدوات الذكاء الاصطناعي