البدء

يمنحك Felo API Platform مفتاحًا واحدًا لأدوات الوكلاء وبروتوكولات النماذج وواجهات Search وWeb Fetch وPPT وMindmap وLiveDocs وX Search وYouTube Subtitling وLanding Page وSuperAgent API. ابدأ من هنا، واختر الأداة التي تستخدمها، ثم اتبع دليل الإعداد المخصص لتلك الأداة.

هل أنت جديد هنا؟ اقرأ نظرة عامة على المنصة لمعرفة كيفية تكامل Model API وData API وواجهات Felo API، أو انتقل مباشرةً إلى البروتوكولات وSDK والقنوات وتوجيه المزوّد.

إعداد Codex أو Claude Code عبر CLI

بعد تثبيت Node.js 22 أو أحدث وأداتك للذكاء الاصطناعي، شغّل:

npx feloapi-cli setup

اتبع المطالبات للصق مفتاح Felo API الكامل واختيار النماذج أو Skills أو كليهما. ثم شغّل أداتك عبر npx feloapi-cli run codex أو npx feloapi-cli run claude-code.

تثبيت CLI واستخدامه

مسار البدء السريع

1. احصل على مفتاح Felo API Platform واشترِ أرصدة الخدمة عند الحاجة؛ لا يلزم اشتراك.
2. اختر أداة الذكاء الاصطناعي أو المنصة من الجدول أدناه.
3. افتح دليل الإعداد المطابق والصق عنوان URL الأساسي الخاص بـFelo ومفتاح API.
4. شغّل مهمة صغيرة في تلك الأداة لتأكيد الاتصال.
5. أضف واجهات API لسير العمل عندما يحتاج وكيلك إلى البحث أو مخرجات المكتب أو استخراج الويب أو مسارات عمل الصور أو LiveDocs أو SuperAgent.

الخطوة 1: احصل على مفتاح API

يستخدم Felo API Platform مفتاح API واحدًا عبر استدعاءات API المباشرة وأدوات الذكاء الاصطناعي المدعومة.

1. افتح صفحة مفاتيح API في Felo API Platform.
2. سجّل الدخول بحساب Felo إذا طُلب منك ذلك.
3. أدخل اسمًا للمفتاح وانقر على Create Key.
4. انسخ المفتاح الكامل عند ظهوره. لا يُعرض إلا مرة واحدة.
5. خزّن المفتاح بأمان واستخدمه باسم FELO_API_KEY.

أعد الشحن حسب الحاجة من Console Billing بدءًا من $1. تشتري أرصدة خدمة مقوّمة بالدولار الأمريكي مقابل استخدام API الفعلي. لا يلزم اشتراك.

عيّن المفتاح كمتغير بيئة:

export FELO_API_KEY="YOUR_API_KEY"

Windows PowerShell:

$env:FELO_API_KEY="YOUR_API_KEY"

الخطوة 2: اختر أداة الذكاء الاصطناعي

انقر على الأداة التي تريد استخدامها. يفتح كل رابط دليل إعداد مخصصًا يتضمن عنوان URL الأساسي الصحيح ومتغيرات البيئة وخطوة التحقق.

الخطوة 3: استخدم عنوان URL الأساسي الصحيح

تطلب معظم الأدوات ثلاث قيم: مفتاح API وعنوان URL الأساسي واسم النموذج. اختر عنوان URL الأساسي وفق البروتوكول الذي تدعمه الأداة.

إذا لم تكن متأكدًا من الوضع الذي يدعمه عميلك، فابدأ بعنوان URL الأساسي المتوافق مع OpenAI. استخدم عنوان URL الأساسي المتوافق مع Anthropic مع Claude Code أو العملاء الذين يطلبون صراحةً endpoint رسائل Anthropic.

الخطوة 4: تحقق عبر استدعاء API مباشر

إذا كنت تريد فقط التأكد من أن مفتاحك يعمل، فاستدعِ Chat API مباشرةً.

curl -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Research the latest AI agent product trends"
  }'

تتضمن الاستجابة الناجحة إجابة وتحليلًا للاستعلام وموارد ويب.

{
  "status": "ok",
  "data": {
    "id": "HabCj883yHLSXc8mWqu4Eq",
    "message_id": "18ea8517-5559-4f48-a355-1f8a79e73b71",
    "answer": "...",
    "query_analysis": {
      "queries": ["AI agent product trends"]
    },
    "resources": [
      {
        "link": "https://example.com/report",
        "title": "AI Agent Market Report",
        "snippet": "..."
      }
    ]
  }
}

الخطوة 5: أضف واجهات API لسير العمل

بعد نجاح أول أداة أو استدعاء API لديك، اربط واجهات API التي تناسب سيناريوك.

أمثلة مباشرة على API

إذا كنت تبني مباشرةً على API بدلًا من إعداد أداة ذكاء اصطناعي، فابدأ بأحد هذه الاستدعاءات الدنيا.

إنشاء مهمة PPT

استخدم PPT Task API عندما تريد توليد عرض تقديمي بشكل غير متزامن. تعيد الاستجابة task_id يمكنك استطلاعه.

curl -X POST https://openapi.felo.ai/v2/ppts \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Create a 5-slide strategy deck about AI agents for office productivity"
  }'

مثال على الاستجابة:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "livedoc_short_id": "PvyKouzJirXjFdst4uKRK3",
    "ppt_business_id": "BfLPuQKmChk9SPmyQawxgr"
  }
}

استطلع حالة المهمة:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

إنشاء مهمة صفحة هبوط

استخدم Landing Page Task API عندما تريد أن يولّد Felo صفحة هبوط من موجّه.

curl -X POST https://openapi.felo.ai/v2/landing_page \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Generate a launch landing page for an AI research assistant"
  }'

مثال على الاستجابة:

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9",
    "thread_short_id": "9qiLTmT77fA3aVurrMHvRJ"
  }
}

استطلع نفس endpoint حالة المهمة الذي تستخدمه مهام PPT:

curl -X GET https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status \
  -H "Authorization: Bearer $FELO_API_KEY"

Python

import os
import requests

api_key = os.environ["FELO_API_KEY"]

response = requests.post(
    "https://openapi.felo.ai/v2/chat",
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={"query": "What are the latest AI agent product trends?"},
    timeout=60,
)

response.raise_for_status()
print(response.json()["data"]["answer"])

JavaScript (Node.js)

const response = await fetch("https://openapi.felo.ai/v2/chat", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FELO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "What are the latest AI agent product trends?",
  }),
});

if (!response.ok) {
  throw new Error(`Felo API request failed: ${response.status}`);
}

const result = await response.json();
console.log(result.data.answer);

مشكلات الإعداد الشائعة

الخطوات التالية

• إعداد Codex
• إعداد Claude Code
• دليل المصادقة
• مرجع LLM API
• مرجع Chat API
• مرجع SuperAgent API