# Pengaturan Felo API

Atur endpoint Felo di Data API untuk pencarian, konten web, data X, dan presentasi, menggunakan saldo platform.

Felo adalah satu penyedia di [Data API](https://openapi.felo.ai/id/docs/data-api), yang menawarkan pencarian web, pembacaan web, data X, jawaban berbasis pencarian, dan presentasi. Temukan setiap endpoint Felo bersama penyedia lain dalam kategori Data API yang relevan.

Endpoint ini menggunakan **saldo platform** dan awalan `/api/v1/data`. Panduan ini menjelaskan autentikasi, permintaan pertama Anda, dan di mana menemukan aturan penagihan.

Untuk menggunakan kredit Felo Pro, lihat [Felo APIs yang sudah ada](https://openapi.felo.ai/id/docs/api-reference/felo-apis.md). Saldo platform dan kredit Pro adalah terpisah.

## Buat permintaan pertama Anda

1. Buat kunci di [Console → API Keys](https://openapi.felo.ai/console/api-keys).
2. Periksa atau isi ulang **saldo platform** Anda di [Console → Billing](https://openapi.felo.ai/console/billing).
3. Tetapkan kunci di server Anda atau di shell lokal Anda:

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

Kirim `Authorization: Bearer $FELO_API_KEY`. `X-API-Key` juga diterima; pilih salah satu metode autentikasi. Permintaan JSON memerlukan `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 mengembalikan array `resources` yang berisi judul halaman, tautan, dan cuplikan, plus `total`. Ini tidak menghasilkan jawaban percakapan; gunakan [Chat](https://openapi.felo.ai/id/docs/data-api/guides/felo-chat.md) untuk itu.

## Jelajahi API

| Panduan | Operasi | Yang Anda terima | Unit penagihan |
|---|---|---|---|
| [Pencarian Web](https://openapi.felo.ai/id/docs/data-api/guides/felo-web-search.md) | Cari web | Judul halaman, tautan, dan cuplikan | Permintaan |
| [Baca Web](https://openapi.felo.ai/id/docs/data-api/guides/felo-web-read.md) | Baca URL | Markdown, teks, HTML, atau tangkapan layar | Permintaan |
| [Data X](https://openapi.felo.ai/id/docs/data-api/guides/felo-x-data.md) | Profil, pencarian pengguna, postingan pengguna, pencarian postingan, balasan | Pengguna dan postingan terstruktur, dengan paginasi jika didukung | Hasil yang dikembalikan |
| [Chat Berbasis Pencarian](https://openapi.felo.ai/id/docs/data-api/guides/felo-chat.md) | Menjawab pertanyaan | Jawaban dan sumber web | Permintaan |
| [PPT](https://openapi.felo.ai/id/docs/data-api/guides/felo-ppt.md) | Buat, status, hasil, ekspor, status ekspor, hapus | Tugas pembuatan dan PPTX yang dapat diunduh | Halaman yang dihasilkan; ekspor ditagihkan terpisah |
| [Penagihan dan Kesalahan](https://openapi.felo.ai/id/docs/data-api/guides/felo-billing.md) | Panduan integrasi bersama | Harga, penanganan saldo, dan aturan retry | — |

Ada **14 operasi inti** di seluruh panduan ini. Jika pembuatan PPT mengembalikan `stream_key`, [panduan PPT](https://openapi.felo.ai/id/docs/data-api/guides/felo-ppt.md#baca-peristiwa-pembuatan-dengan-sse) juga menjelaskan cara membaca peristiwa pembuatan dengan SSE. Kueri status dan hasil, kueri status ekspor, serta penghapusan tidak membuat biaya baru.

## Sebelum memindahkan integrasi yang sudah ada

Gunakan panduan untuk endpoint yang Anda panggil secara tepat. Mengganti `/v2` dengan `/api/v1/data` bukan migrasi yang lengkap:

- Web Read menggunakan `/web/read`, dengan satu format keluaran per permintaan.
- Chat mengembalikan `status: "ok"`; ini hanya mendukung JSON non-streaming.
- Hasil PPT menggunakan **POST** `/tasks/{task_id}/historical`.
- Pembuatan PPT mengembalikan pengenal di root JSON. Simpan `task_id` dan `ppt_business_id`.
- PPT yang dihasilkan kedaluwarsa setelah tujuh hari. Ekspor dan simpan file Anda sebelum kedaluwarsa.

Tidak ada padanan OpenAPI native yang didokumentasikan di sini untuk setiap alur kerja `/v2`, seperti CRUD LiveDoc, Mindmap, atau SuperAgent. Tetap gunakan [panduan Felo APIs](https://openapi.felo.ai/id/docs/api-reference/felo-apis.md) dan penagihan kredit Pro.

## Kontrak dan harga terkini

- [Skema OpenAPI yang dipublikasikan](https://openapi.felo.ai/api/v1/data/openapi.json) — definisi bidang dan skema respons.
- [Skema OpenAPI YAML](https://openapi.felo.ai/api/v1/data/openapi.yaml) — untuk alat yang menerima YAML.
- [Harga terkini](https://openapi.felo.ai/api/v1/data/prices) — ID operasi, unit penagihan, dan tarif saat ini.

Sumber-sumber ini bersifat publik dan dapat dibaca tanpa kunci. Lihat [Penagihan dan Kesalahan](https://openapi.felo.ai/id/docs/data-api/guides/felo-billing.md) sebelum menambahkan retry otomatis.