# แชตแบบอิงการค้นหา

สร้างคำตอบพร้อมแหล่งข้อมูลเว็บโดยใช้ยอดคงเหลือบนแพลตฟอร์ม.

ส่งคำถามและรับคำตอบที่สร้างพร้อมแหล่งข้อมูลเว็บใน response เดียว

ตัวอย่างทั้งหมดใช้ `FELO_API_KEY` จาก [ภาพรวม](https://openapi.felo.ai/th/docs/data-api/guides/felo-overview.md) การเรียกใช้ใช้ **ยอดคงเหลือบนแพลตฟอร์ม** ไม่ใช่ Felo Pro credits ตัวอย่างการตอบกลับมีไว้เพื่อประกอบการอธิบาย; เนื้อหาจริงและฟิลด์เสริมอาจแตกต่างกัน

## เอนด์พอยต์

`POST /api/v1/data/chat`

นี่คือเอนด์พอยต์สำหรับยอดคงเหลือบนแพลตฟอร์ม [Felo Search API](https://openapi.felo.ai/th/docs/api-reference/chat.md) ที่ `/v2/chat` ใช้ Pro credits และมี response envelope ต่างออกไป

## คำขอ

| ฟิลด์ | ประเภท | จำเป็น | ความหมาย |
|---|---|---|---|
| `query` | string | ใช่ | คำถาม, 1–2,000 อักขระ |
| `accept_language` | string | ไม่ | ภาษาที่ต้องการสำหรับคำตอบ เช่น `en`, `ja`, หรือ `zh-CN`; ยาวได้สูงสุด 64 อักขระ |
| `stream` | boolean | ไม่ | ต้องเป็น `false`; ค่าเริ่มต้นเป็น `false` |

ใช้ภาษาแท็กที่มีรหัสภาษายาว 2–8 ตัวอักษรและอาจมี subtag คั่นด้วยขีดกลาง เช่น `zh-TW` บริการจะเพิ่ม preference นี้เข้าไปในคำขอสร้าง หากละไว้ upstream service จะเลือกภาษาเอง; ไม่มีค่าเริ่มต้นตายตัว และคำถามภาษาอังกฤษไม่ได้รับประกันว่าจะได้คำตอบภาษาอังกฤษ preference นี้ใช้กับคำตอบที่สร้างขึ้น; ชื่อเรื่องและข้อความตัดตอนของแหล่งข้อมูลยังคงภาษาเดิม

เอนด์พอยต์นี้ส่งคืน JSON แบบไม่สตรีม ไม่รองรับ `stream: true`, SSE, อาร์เรย์ `messages` หรือการเลือก 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}'
```

## การตอบกลับ

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` | ตัวระบุของ response |

ตรวจสอบ HTTP status ก่อน แล้วค่อยอ่านคำตอบและแหล่งข้อมูล อย่าตรวจ `status: 200` แบบตัวเลขเหมือนที่คุณอาจทำกับ `/v2/chat`

## การเรียกเก็บเงิน

`chat` คิดค่าบริการต่อคำขอ ไม่ใช่ตาม token ของ model ดู [ราคาปัจจุบัน](https://openapi.felo.ai/api/v1/data/prices) และ [Billing and Errors](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md)