Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

شرح نتائج البحث

الخادم:https://openapi.felo.ai
مكتبات العملاء

شرح نتائج البحث

​

اشرح نتائج بحث تم جلبها سابقًا. قدّم search_id الذي يعيده بحث Scholar، مع detail_level وlanguage الاختياريين. يعيد response_mode=NON_STREAMING ملف JSON مع message؛ ويعيد COMPLETE وINCREMENTAL النوع text/event-stream، حيث يحمل كل حدث الشرح المتراكم. هذه العملية تشرح بحثًا موجودًا ولا تبدأ بحثًا آخر.

مرجع التسعير

  • القياس: أساس تكلفة ثابت لكل طلب ناجح.
  • تقدير الطلب المرجعي: 0.01 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
مطلوب
application/json
  • search_id
    النوع: string
    مطلوب

    معرّف البحث المراد شرحه

  • detail_level
    النوع: string تعداد

    مستوى التفصيل في الشرح

    القيم
    • BRIEF
    • MODERATE
    • DETAILED
  • language
    النوع: string

    رمز اللغة للشرح (مثل en، zh، ar)

  • response_mode
    النوع: string تعداد

    تنسيق استجابة الشرح. تبث COMPLETE وINCREMENTAL أحداثًا مرسلة من الخادم؛ وتعيد NON_STREAMING استجابة JSON.

    القيم
    • COMPLETE
    • INCREMENTAL
    • NON_STREAMING
الاستجابات
  • 200
    النوع: object · Response8Da310D1D213_ExplainSearchResponse

    استجابة شرح ناجحة. تبثّ COMPLETE/INCREMENTAL النوع text/event-stream؛ ويعيد NON_STREAMING النوع application/json.

    استجابة شرح JSON المعادة عندما تكون response_mode هي NON_STREAMING.

    • message
      النوع: string
      مطلوب

      نص الشرح المُولّد.

  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/scholar/search/explain
curl https://openapi.felo.ai/v1/beta/scholar/search/explain \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "search_id": "",
  "response_mode": "NON_STREAMING",
  "language": "ar",
  "detail_level": "MODERATE"
}'
{
  "message": "string"
}
Explain search results