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

POST /api/v1/data/chat

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

تستخدم جميع الأمثلة `FELO_API_KEY` من [نظرة عامة](https://openapi.felo.ai/ar/docs/data-api/guides/felo-overview.md). تستخدم الاستدعاءات **رصيد المنصة**، وليس أرصدة Felo Pro. أمثلة الاستجابة توضيحية؛ ويختلف المحتوى الحي والحقول الاختيارية.

## نقطة النهاية

`POST /api/v1/data/chat`

هذه هي نقطة نهاية رصيد المنصة. [Felo Search API](https://openapi.felo.ai/ar/docs/api-reference/chat.md) في `/v2/chat` تستخدم أرصدة Pro ولها غلاف استجابة مختلف.

## الطلب

| الحقل | النوع | مطلوب | المعنى |
|---|---|---|---|
| `query` | string | نعم | السؤال، 1–2,000 حرف |
| `accept_language` | string | لا | لغة الإجابة المفضلة، مثل `en` أو `ja` أو `zh-CN`; حتى 64 حرفًا |
| `stream` | boolean | لا | يجب أن تكون `false`; والافتراضي `false` |

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

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

```bash
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`:

```json
{
  "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"]}
  }
}
```

| الحقل | المعنى |
|---|---|
| `data.answer` | الإجابة المُولدة |
| `data.resources` | صفحات المصدر مع العناوين والروابط والمقتطفات |
| `data.query_analysis` | تحليل اختياري للاستعلام؛ قد يكون null |
| `data.id`, `data.message_id` | معرفات الاستجابة |

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

## الفوترة

يُفوتر `chat` لكل طلب، وليس بواسطة رموز النموذج. راجع [الأسعار الحالية](https://openapi.felo.ai/api/v1/data/prices) و[الفوترة والأخطاء](https://openapi.felo.ai/ar/docs/data-api/guides/felo-billing.md).