# Gambaran Keseluruhan Felo API

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

Untuk membayar carian web, bacaan web, data X, Sembang atau PPT dengan **baki platform**, gunakan [Felo dalam Data API](https://openapi.felo.ai/ms/docs/api-reference/openapi/overview.md). Halaman ini mendokumentasikan API `/v2` sedia ada, yang menggunakan **kredit Felo Pro**.

API Felo ialah API pihak pertama pada tahap aliran kerja untuk carian, dokumen, persembahan, ekstraksi web, carian sosial dan aliran kerja ejen. Ia menggunakan kunci API Felo yang sama seperti seluruh platform, tetapi dibilkan secara berasingan daripada panggilan model.

::: tip Kredit langganan Felo Pro
**API Felo pada masa ini menerima kredit langganan Felo Pro.** Ini terpakai kepada API `/v2` pihak pertama dalam bahagian ini: Felo Search, PPT Task, Mindmap, LiveDoc, Web Fetch, X Search, YouTube Subtitling, Landing Page dan SuperAgent.

Ini tidak terpakai kepada panggilan Model API (`/api/v1`). Panggilan model memerlukan kredit perkhidmatan Felo API Platform prabayar; kredit langganan Felo Pro tidak boleh digunakan untuknya.
:::

Kelayakan boleh berubah. Halaman [Console Billing](https://openapi.felo.ai/console/billing) ialah sumber kebenaran untuk baki dan penggunaan semasa anda.

## API dalam bahagian ini

| API | Titik akhir | Digunakan untuk |
|---|---|---|
| [API Carian Felo](https://openapi.felo.ai/ms/docs/api-reference/chat.md) | `POST /v2/chat` | Carian web perbualan dengan analisis pertanyaan, sumber dan petikan |
| [API Tugas PPT](https://openapi.felo.ai/ms/docs/api-reference/ppt-tasks.md) | `POST /v2/ppts` | Jana dek slaid dan undi status tugas |
| [API Mindmap](https://openapi.felo.ai/ms/docs/api-reference/mindmap.md) | `POST /v2/mindmap` | Tukar prompt atau konteks LiveDoc kepada mindmap |
| [API LiveDoc](https://openapi.felo.ai/ms/docs/api-reference/livedocs.md) | `POST /v2/livedocs` | Cipta pangkalan pengetahuan, urus sumber dan ambil semula konteks |
| [API Web Fetch](https://openapi.felo.ai/ms/docs/api-reference/web-fetch.md) | `POST /v2/web/extract` | Ekstrak halaman web sebagai HTML, teks atau Markdown |
| [API Carian X](https://openapi.felo.ai/ms/docs/api-reference/x-search.md) | `POST /v2/x/tweet/search` | Cari pengguna X, tweet, garis masa dan balasan |
| [API Sari Kata YouTube](https://openapi.felo.ai/ms/docs/api-reference/youtube-subtitling.md) | `GET /v2/youtube/subtitling` | Ambil sari kata YouTube dan cap masa |
| [API Tugas Halaman Pendaratan](https://openapi.felo.ai/ms/docs/api-reference/landing-page.md) | `POST /v2/landing_page` | Jana halaman pendaratan secara tak segerak |
| [API SuperAgent](https://openapi.felo.ai/ms/docs/api-reference/superagent.md) | `POST /v2/conversations` | Jalankan perbualan ejen melalui SSE |

## Pengesahan dan panggilan pertama

Cipta satu kunci API Felo dalam [Console → API Keys](https://openapi.felo.ai/console/api-keys) dan hantarkannya sebagai token Bearer.

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

Respons berjaya merangkumi jawapan, analisis pertanyaan dan sumber web yang dipetik.

## Model pengebilan

| Permukaan | Laluan | Cara panggilan dibayar |
|---|---|---|
| API Felo | `/v2/*` | Kredit Felo Pro |
| [Felo dalam Data API](https://openapi.felo.ai/ms/docs/api-reference/openapi/overview.md) | `/api/v1/data/*` | Baki platform, bukan kredit Pro |
| Model API | `/api/v1/*` | Hanya kredit perkhidmatan Felo API Platform prabayar; Felo Pro tidak terpakai |
| Data API | `/v1/beta/*` | Menggunakan asas pengebilan katalog API yang ditunjukkan untuk setiap titik akhir |

Kredit Felo Pro dan kredit perkhidmatan API ialah baki yang berasingan. Langganan Felo Pro tidak secara automatik memberikan kredit perkhidmatan API, dan kredit perkhidmatan API tidak menambah kredit langganan Felo Pro.

## Berkaitan

- [API Carian Felo](https://openapi.felo.ai/ms/docs/api-reference/chat.md)
- [Pengebilan dan Kredit](https://openapi.felo.ai/ms/docs/faq/billing-and-credits.md)
- [Ralat, Had dan Percubaan Semula](https://openapi.felo.ai/ms/docs/guides/errors-and-limits.md)
- [Console Billing](https://openapi.felo.ai/console/billing)"}}}