# צ'אט מבוסס-חיפוש

הפק תשובה עם מקורות מהאינטרנט באמצעות יתרת הפלטפורמה.

שלחו שאלה וקבלו תשובה שנוצרה יחד עם מקורות אינטרנט בתגובה אחת.

כל הדוגמאות משתמשות ב-`FELO_API_KEY` מתוך [הסקירה הכללית](https://openapi.felo.ai/he/docs/data-api/guides/felo-overview.md). הקריאות משתמשות ב-**יתרת הפלטפורמה**, ולא ב-Felo Pro credits. דוגמאות התגובה הן להמחשה; תוכן חי ושדות אופציונליים משתנים.

## נקודת קצה

`POST /api/v1/data/chat`

זהו נקודת הקצה של יתרת הפלטפורמה. [Felo Search API](https://openapi.felo.ai/he/docs/api-reference/chat.md) ב-`/v2/chat` משתמש ב-Pro credits ובמעטפת תגובה שונה.

## בקשה

| שדה | סוג | נדרש | משמעות |
|---|---|---|---|
| `query` | string | כן | שאלה, 1–2,000 תווים |
| `accept_language` | string | לא | שפת תשובה מועדפת, כגון `en`, `ja`, או `zh-CN`; עד 64 תווים |
| `stream` | boolean | לא | חייב להיות `false`; ברירת מחדל `false` |

השתמשו בתגית שפה עם קוד שפה בן 2–8 אותיות ותתי-תגים אופציונליים מופרדים במקף, כגון `zh-TW`. השירות מוסיף העדפה זו לבקשת היצירה. אם היא מושמטת, שירות ה-upstream בוחר את השפה; אין ברירת מחדל קבועה, ושאלה באנגלית אינה מבטיחה תשובה באנגלית. ההעדפה חלה על התשובה שנוצרת; כותרות מקורות וקטעים שומרים על השפה המקורית שלהם.

נקודת קצה זו מחזירה 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/he/docs/data-api/guides/felo-billing.md).