# การตั้งค่า Felo API

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

Felo เป็นหนึ่งใน provider ภายใต้ [Data API](https://openapi.felo.ai/th/docs/data-api) ที่ให้บริการการค้นหาเว็บ การอ่านเว็บ ข้อมูล X คำตอบแบบอิงการค้นหา และงานนำเสนอ ค้นหาเอนด์พอยต์ของ Felo แต่ละตัวได้เคียงข้าง provider อื่นในหมวดหมู่ Data API ที่เกี่ยวข้อง

เอนด์พอยต์เหล่านี้ใช้ **ยอดคงเหลือบนแพลตฟอร์ม** และคำนำหน้า `/api/v1/data` คู่มือนี้อธิบายการยืนยันตัวตน คำขอแรกของคุณ และตำแหน่งที่จะค้นหากฎการเรียกเก็บเงิน

หากต้องการใช้ Felo Pro credits ให้ดู [Felo APIs ที่มีอยู่](https://openapi.felo.ai/th/docs/api-reference/felo-apis.md) ยอดคงเหลือบนแพลตฟอร์มและ Pro credits แยกจากกัน

## ทำคำขอแรกของคุณ

1. สร้าง key ใน [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. ตรวจสอบหรือเติมเงิน **ยอดคงเหลือบนแพลตฟอร์ม** ของคุณใน [Console → Billing](https://openapi.felo.ai/console/billing).
3. ตั้งค่า key บนเซิร์ฟเวอร์ของคุณหรือใน shell ภายในเครื่อง:

```bash
export FELO_API_KEY="YOUR_API_KEY"
```

ส่ง `Authorization: Bearer $FELO_API_KEY` `X-API-Key` ก็ใช้ได้เช่นกัน; เลือกวิธีการยืนยันตัวตนเพียงแบบเดียว คำขอ JSON ต้องมี `Content-Type: application/json`

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What is retrieval augmented generation?","count":3}'
```

HTTP 200 ส่งคืนอาร์เรย์ `resources` พร้อมชื่อเรื่อง ลิงก์ และตัวอย่างข้อความ รวมถึง `total` มันไม่สร้างคำตอบแบบสนทนา; ใช้ [Chat](https://openapi.felo.ai/th/docs/data-api/guides/felo-chat.md) สำหรับกรณีนั้น

## สำรวจ API

| คู่มือ | การทำงาน | สิ่งที่คุณได้รับ | หน่วยการเรียกเก็บเงิน |
|---|---|---|---|
| [Web Search](https://openapi.felo.ai/th/docs/data-api/guides/felo-web-search.md) | ค้นหาเว็บ | ชื่อเรื่อง ลิงก์ และตัวอย่างข้อความ | คำขอ |
| [Web Read](https://openapi.felo.ai/th/docs/data-api/guides/felo-web-read.md) | อ่าน URL | Markdown ข้อความ HTML หรือภาพหน้าจอ | คำขอ |
| [X Data](https://openapi.felo.ai/th/docs/data-api/guides/felo-x-data.md) | โปรไฟล์, ค้นหาผู้ใช้, โพสต์ของผู้ใช้, ค้นหาโพสต์, คำตอบ | ผู้ใช้และโพสต์แบบมีโครงสร้าง พร้อมการแบ่งหน้าที่รองรับ | ผลลัพธ์ที่ส่งคืน |
| [Search-grounded Chat](https://openapi.felo.ai/th/docs/data-api/guides/felo-chat.md) | ตอบคำถาม | คำตอบและแหล่งข้อมูลเว็บ | คำขอ |
| [PPT](https://openapi.felo.ai/th/docs/data-api/guides/felo-ppt.md) | สร้าง, สถานะ, ผลลัพธ์, ส่งออก, สถานะการส่งออก, ลบ | task การสร้างและ PPTX ที่ดาวน์โหลดได้ | หน้าที่สร้าง; การส่งออกคิดแยกต่างหาก |
| [Billing and Errors](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md) | คำแนะนำการผสานรวมร่วมกัน | ราคา, การจัดการยอดคงเหลือ และกฎการลองใหม่ | — |

มี **14 การทำงานหลัก** ครอบคลุมคู่มือเหล่านี้ หากการสร้าง PPT ส่งคืน `stream_key` คู่มือ [PPT](https://openapi.felo.ai/th/docs/data-api/guides/felo-ppt.md#sse) ยังอธิบายวิธีอ่านเหตุการณ์การสร้างด้วย SSE ด้วย คำขอสถานะและผลลัพธ์, คำขอสถานะการส่งออก และการลบ ไม่สร้างการคิดค่าบริการใหม่

## ก่อนย้ายการผสานรวมที่มีอยู่

ใช้คู่มือของเอนด์พอยต์ที่คุณเรียกอย่างตรงตัว การแทนที่ `/v2` ด้วย `/api/v1/data` ไม่ใช่การย้ายครบถ้วน:

- Web Read ใช้ `/web/read` โดยมีรูปแบบผลลัพธ์ได้ครั้งละหนึ่งแบบต่อคำขอ
- Chat ส่งกลับ `status: "ok"`; รองรับเฉพาะ JSON แบบไม่สตรีม
- ผลลัพธ์ PPT ใช้ **POST** `/tasks/{task_id}/historical`
- การสร้าง PPT ส่งคืนตัวระบุที่ราก JSON บันทึกทั้ง `task_id` และ `ppt_business_id`
- PPT ที่สร้างแล้วหมดอายุหลังเจ็ดวัน ส่งออกและบันทึกไฟล์ของคุณก่อนหมดอายุ

ไม่มี native OpenAPI ที่ระบุไว้ที่นี่สำหรับทุกเวิร์กโฟลว์ `/v2` เช่น LiveDoc CRUD, Mindmap หรือ SuperAgent ให้ใช้ต่อไปที่ [คู่มือ Felo APIs](https://openapi.felo.ai/th/docs/api-reference/felo-apis.md) และการเรียกเก็บเงินแบบ Pro-credit

## สัญญาและราคาปัจจุบัน

- [OpenAPI schema ที่เผยแพร่](https://openapi.felo.ai/api/v1/data/openapi.json) — คำจำกัดความของฟิลด์และ response schemas
- [OpenAPI YAML schema](https://openapi.felo.ai/api/v1/data/openapi.yaml) — สำหรับเครื่องมือที่รองรับ YAML
- [ราคาปัจจุบัน](https://openapi.felo.ai/api/v1/data/prices) — operation IDs หน่วยการเรียกเก็บเงิน และอัตราปัจจุบัน

ทรัพยากรเหล่านี้เป็นสาธารณะและอ่านได้โดยไม่ต้องใช้ key ดู [Billing and Errors](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md) ก่อนเพิ่มการลองใหม่อัตโนมัติ