دردشة معتمدة على البحث

أرسل سؤالًا واستلم إجابة مُولدة مع مصادر ويب في استجابة واحدة.

تستخدم جميع الأمثلة FELO_API_KEY من نظرة عامة. تستخدم الاستدعاءات رصيد المنصة، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

نقطة النهاية

POST /api/v1/data/chat

هذه هي نقطة نهاية رصيد المنصة. Felo Search API في /v2/chat تستخدم أرصدة Pro ولها غلاف استجابة مختلف.

الطلب

استخدم وسم لغة مع رمز لغة من حرفين إلى 8 أحرف ووسوم فرعية اختيارية مفصولة بشرطات، مثل zh-TW. تضيف الخدمة هذه التفضيلات إلى طلب التوليد. إذا أُهملت، تختار الخدمة الأصلية اللغة؛ لا يوجد افتراضي ثابت، كما أن السؤال بالإنجليزية لا يضمن إجابة بالإنجليزية. تنطبق التفضيلات على الإجابة المُولدة؛ أما عناوين المصادر ومقتطفاتها فتبقى بلغتها الأصلية.

تعيد هذه النقطة JSON غير متدفق. وهي لا تدعم stream: true أو SSE أو مصفوفة messages أو اختيار النموذج.

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/chat" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Explain retrieval augmented generation and cite sources.","accept_language":"en","stream":false}'

الاستجابة

يعيد HTTP 200 قيمة status: "ok" وكائن data:

{
  "status": "ok",
  "data": {
    "id": "example-chat-id",
    "message_id": "example-message-id",
    "answer": "Retrieval augmented generation adds retrieved context to a model request...",
    "resources": [
      {"title":"Example reference","link":"https://example.com/guide","snippet":"An overview of retrieval augmented generation."}
    ],
    "query_analysis": {"queries":["retrieval augmented generation"]}
  }
}

تحقق من حالة HTTP أولًا، ثم اقرأ الإجابة والمصادر. لا تختبر قيمة رقمية status: 200 كما قد تفعل مع /v2/chat.

الفوترة

يُفوتر chat لكل طلب، وليس بواسطة رموز النموذج. راجع الأسعار الحالية والفوترة والأخطاء.