Panduan
Ringkasan Data API
Panggil endpoint pihak ketiga melalui satu prefiks bersama, dengan autentikasi dan penanganan permintaan yang konsisten.
Data API menyertakan penyedia Felo dan pihak ketiga dalam direktori yang sama, di bawah kategori yang sudah ada. Panggilan menggunakan saldo platform; Felo APIs /v2 yang sudah ada menggunakan kredit Pro. Awalan bersama di bawah berlaku untuk penyedia pihak ketiga; lihat pengaturan Felo untuk jalur dan contoh Felo.
Awalan bersama
https://openapi.felo.ai/v1/betaReferensi menampilkan setiap endpoint sebagai jalur lengkap yang dimulai dengan /v1/beta. Gunakan jalur itu apa adanya pada host; jangan tambahkan awalan bersama lagi. Misalnya, endpoint pencarian Tavily adalah:
POST https://openapi.felo.ai/v1/beta/tavily/searchTemukan endpoint
- Telusuri direktori API berdasarkan penyedia.
- Buka referensi Data API untuk daftar endpoint lengkap, parameter, dan skema respons.
- Gunakan tag referensi untuk berpindah antar penyedia.
Setiap penyedia mempertahankan bentuk permintaannya sendiri. Lapisan bersama menstandarkan autentikasi dan routing, bukan payload. Baca skema endpoint sebelum mengirim permintaan.
Autentikasi
Gunakan salah satu header:
Authorization: Bearer $FELO_API_KEYatau:
X-API-Key: $FELO_API_KEYKirim Content-Type: application/json untuk body JSON.
Contoh permintaan
curl https://openapi.felo.ai/v1/beta/tavily/search \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "What is Felo AI?",
"max_results": 3
}'Bentuk respons berasal dari penyedia. Bidang seperti hasil, cursor paginasi, dan metadata tidak dinormalisasi lintas penyedia.
Konvensi
| Topik | Yang diharapkan |
|---|---|
| Payload | JSON khusus penyedia; ikuti skema endpoint |
| Paginasi | Nama bidang dan gaya cursor bervariasi menurut endpoint |
| Kesalahan | JSON dengan status, code, message, dan request_id; detail penyedia dapat muncul di pesan |
| Batas laju | Khusus endpoint dan penyedia; harapkan 429 saat beban tinggi |
| Penagihan | Per panggilan, dari saldo kredit layanan yang sama dengan Model API |
Penanganan kesalahan
Kegagalan autentikasi mengembalikan pembungkus yang sama seperti sisa platform:
{
"status": 401,
"code": "UNAUTHORIZED",
"message": "Invalid API Key",
"request_id": "..."
}Untuk kegagalan di tingkat penyedia, baca status HTTP dan pesan. Catat method, path lengkap, bentuk body permintaan, dan request_id. Jangan catat API key penuh.
Retry
Retry respons 429 dan 5xx dengan backoff. Jangan retry 400 atau 401 tanpa perubahan. Beberapa operasi penyedia tidak aman untuk diulang; periksa endpoint sebelum retry tulis.
Kapan menggunakan Felo API sebagai gantinya
Gunakan Data API ketika Anda membutuhkan sumber data pihak ketiga yang spesifik. Gunakan Felo API ketika Anda menginginkan alur kerja milik Felo:
- Jawaban berbasis pencarian dengan sitasi: Chat API
- Pembuatan slide: PPT Task API
- Landing page: Landing Page Task API
- Basis pengetahuan dan pengambilan: LiveDoc API
- Percakapan agen dengan streaming: SuperAgent API
Terkait
Butuh bantuan?
- Ada pertanyaan soal API, penagihan, atau akun? Hubungi dukungan.
- Ngobrol dengan pengembang Felo di Discord.
- Lihat catatan perubahan kami.
- Butuh harga volume atau bantuan pengadaan? Hubungi penjualan.
- Sedang membangun dengan LLM? Baca llms.txt.