# ภาพรวม Felo APIs

Felo workflows under /v2, called with Felo Pro credits. Compare them with platform-balance APIs.

หากต้องการจ่ายค่า web search, web reading, ข้อมูล X, Chat หรือ PPT ด้วย **ยอดคงเหลือบนแพลตฟอร์ม** ให้ใช้ [Felo in Data API](https://openapi.felo.ai/th/docs/api-reference/openapi/overview.md) หน้านี้อธิบาย `/v2` APIs ที่มีอยู่ ซึ่งใช้ **Felo Pro credits**

Felo APIs เป็น first-party APIs ระดับเวิร์กโฟลว์สำหรับ search, documents, presentations, web extraction, social search และ agent workflows พวกมันใช้ Felo API key เดียวกันกับส่วนอื่นของแพลตฟอร์ม แต่คิดค่าบริการแยกจาก model calls

::: tip Felo Pro subscription credits
**ปัจจุบัน Felo APIs รับ Felo Pro subscription credits ได้** ซึ่งใช้กับ first-party `/v2` APIs ในส่วนนี้: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page และ SuperAgent

สิ่งนี้ **ไม่** ใช้กับ Model API calls (`/api/v1`) Model calls ต้องใช้ prepaid Felo API Platform service credits; Felo Pro subscription credits ใช้ไม่ได้กับพวกมัน
:::

สิทธิ์ใช้งานอาจเปลี่ยนแปลงได้ หน้า [Console Billing](https://openapi.felo.ai/console/billing) เป็นแหล่งข้อมูลที่ถูกต้องที่สุดสำหรับยอดคงเหลือและการใช้งานปัจจุบันของคุณ

## APIs ในส่วนนี้

| API | เอนด์พอยต์ | ใช้สำหรับ |
|---|---|---|
| [Felo Search API](https://openapi.felo.ai/th/docs/api-reference/chat.md) | `POST /v2/chat` | ค้นหาเว็บแบบสนทนา พร้อม query analysis, sources และ citations |
| [PPT Task API](https://openapi.felo.ai/th/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | สร้างชุดสไลด์และโพลสถานะ task |
| [Mindmap API](https://openapi.felo.ai/th/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | แปลง prompt หรือบริบท LiveDoc เป็น mindmap |
| [LiveDoc API](https://openapi.felo.ai/th/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | สร้าง knowledge bases, จัดการ resources และดึง context |
| [Web Fetch API](https://openapi.felo.ai/th/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | ดึงหน้าเว็บเป็น HTML, text หรือ Markdown |
| [X Search API](https://openapi.felo.ai/th/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | ค้นหา X users, tweets, timelines และ replies |
| [YouTube Subtitling API](https://openapi.felo.ai/th/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | ดึงคำบรรยาย YouTube และ time stamps |
| [Landing Page Task API](https://openapi.felo.ai/th/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | สร้าง landing page แบบอะซิงโครนัส |
| [SuperAgent API](https://openapi.felo.ai/th/docs/api-reference/superagent.md) | `POST /v2/conversations` | รันบทสนทนา agent ผ่าน SSE |

## การยืนยันตัวตนและการเรียกครั้งแรก

สร้าง Felo API key หนึ่งตัวใน [Console → API Keys](https://openapi.felo.ai/console/api-keys) และส่งเป็น Bearer token

```bash
export FELO_API_KEY="YOUR_API_KEY"

curl -sS https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"What are the latest AI agent trends?"}'
```

response ที่สำเร็จจะรวมคำตอบ, query analysis, และ web resources ที่มีการอ้างอิง

## โมเดลการเรียกเก็บเงิน

| ส่วน | Path | การชำระค่าการเรียก |
|---|---|---|
| Felo APIs | `/v2/*` | Felo Pro credits |
| [Felo in Data API](https://openapi.felo.ai/th/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | ยอดคงเหลือบนแพลตฟอร์ม ไม่ใช่ Pro credits |
| Model API | `/api/v1/*` | ใช้เฉพาะ prepaid Felo API Platform service credits; Felo Pro ไม่ครอบคลุม |
| Data API | `/v1/beta/*` | ใช้ฐานการเรียกเก็บเงินของ API catalog ตามที่แสดงสำหรับแต่ละเอนด์พอยต์ |

Felo Pro credits และ API service credits เป็นยอดคงเหลือคนละก้อน Felo Pro subscription ไม่ได้ให้ API service credits โดยอัตโนมัติ และ API service credits ไม่ได้เพิ่ม Felo Pro subscription credits

## ที่เกี่ยวข้อง

- [Felo Search API](https://openapi.felo.ai/th/docs/api-reference/chat.md)
- [Billing and Credits](https://openapi.felo.ai/th/docs/faq/billing-and-credits.md)
- [Errors, Limits, and Retries](https://openapi.felo.ai/th/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)