# Felo تلاش پر مبنی چیٹ

POST /api/v1/data/chat

ایک سوال بھیجیں اور ایک ہی response میں ویب ذرائع کے ساتھ generated answer حاصل کریں۔

تمام examples، [overview](https://openapi.felo.ai/ur/docs/data-api/guides/felo-overview.md) سے `FELO_API_KEY` استعمال کرتے ہیں۔ Calls **platform balance** استعمال کرتی ہیں، Felo Pro credits نہیں۔ Response examples صرف وضاحتی ہیں؛ live content اور optional fields مختلف ہو سکتے ہیں۔

## نقطۂ اختتام

`POST /api/v1/data/chat`

یہ platform-balance endpoint ہے۔ `/v2/chat` پر موجود [Felo Search API](https://openapi.felo.ai/ur/docs/api-reference/chat.md) Pro credits استعمال کرتی ہے اور اس کا response envelope مختلف ہے۔

## درخواست

| فیلڈ | قسم | لازمی | معنی |
| --- | --- | --- | --- |
| `query` | string | ہاں | سوال، 1–2,000 حروف |
| `accept_language` | string | نہیں | ترجیحی جواب کی زبان، جیسے `en`، `ja`، یا `zh-CN`; زیادہ سے زیادہ 64 حروف |
| `stream` | boolean | نہیں | `false` ہونا لازمی ہے؛ طے شدہ `false` |

2–8 حرفی language code اور اختیاری hyphen-separated subtags والا language tag استعمال کریں، جیسے `zh-TW`۔ سروس اس ترجیح کو generation request میں شامل کرتی ہے۔ اگر اسے چھوڑ دیا جائے، تو upstream service language کا انتخاب کرتی ہے؛ کوئی مقررہ default نہیں، اور English سوال English جواب کی guarantee نہیں دیتا۔ یہ ترجیح generated answer پر لاگو ہوتی ہے؛ source titles اور excerpts اپنی اصل language برقرار رکھتے ہیں۔

یہ endpoint non-streaming JSON واپس کرتا ہے۔ یہ `stream: true`، SSE، `messages` array یا model selection کو support نہیں کرتا۔

```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` object واپس کرتا ہے:

```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 چیک کریں، پھر answer اور sources پڑھیں۔ `/v2/chat` کی طرح numeric `status: 200` کے لیے test نہ کریں۔

## بلنگ

`chat` کی بلنگ فی request ہوتی ہے، model tokens کے حساب سے نہیں۔ [current prices](https://openapi.felo.ai/api/v1/data/prices) اور [Billing and Errors](https://openapi.felo.ai/ur/docs/data-api/guides/felo-billing.md) دیکھیں۔