# Sembang Berasaskan Carian Felo

POST /api/v1/data/chat

Hantar soalan dan terima jawapan yang dijana dengan sumber web dalam satu respons.

Semua contoh menggunakan `FELO_API_KEY` daripada [gambaran keseluruhan](https://openapi.felo.ai/ms/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **baki platform**, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.

## Titik akhir

`POST /api/v1/data/chat`

Ini ialah titik akhir baki platform. [API Carian Felo](https://openapi.felo.ai/ms/docs/api-reference/chat.md) pada `/v2/chat` menggunakan kredit Pro dan mempunyai sampul respons yang berbeza.

## Permintaan

| Medan | Jenis | Diperlukan | Makna |
|---|---|---|---|
| `query` | string | Ya | Soalan, 1–2,000 aksara |
| `accept_language` | string | Tidak | Bahasa jawapan pilihan, seperti `en`, `ja`, atau `zh-CN`; maksimum 64 aksara |
| `stream` | boolean | Tidak | Mesti `false`; lalai kepada `false` |

Gunakan tag bahasa dengan kod bahasa 2–8 huruf dan subtajuk pilihan yang dipisahkan dengan tanda sengkang, seperti `zh-TW`. Perkhidmatan menambah keutamaan ini kepada permintaan penjanaan. Jika tidak dinyatakan, perkhidmatan huluan memilih bahasa; tiada lalai tetap, dan soalan bahasa Inggeris tidak menjamin jawapan bahasa Inggeris. Keutamaan terpakai pada jawapan yang dijana; tajuk dan petikan sumber mengekalkan bahasa asalnya.

Titik akhir ini memulangkan JSON tanpa penstriman. Ia tidak menyokong `stream: true`, SSE, tatasusunan `messages` atau pemilihan model.

```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}'
```

## Respons

HTTP 200 memulangkan `status: "ok"` dan objek `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"]}
  }
}
```

| Medan | Makna |
|---|---|
| `data.answer` | Jawapan yang dijana |
| `data.resources` | Halaman sumber dengan tajuk, pautan dan petikan |
| `data.query_analysis` | Analisis pertanyaan pilihan; ia mungkin null |
| `data.id`, `data.message_id` | Pengecam respons |

Semak status HTTP terlebih dahulu, kemudian baca jawapan dan sumber. Jangan uji untuk `status: 200` bernombor seperti yang anda mungkin lakukan dengan `/v2/chat`.

## Pengebilan

`chat` dibilkan bagi setiap permintaan, bukan mengikut token model. Lihat [harga semasa](https://openapi.felo.ai/api/v1/data/prices) dan [Pengebilan dan Ralat](https://openapi.felo.ai/ms/docs/data-api/guides/felo-billing.md).