Felo APIs

Landing Page Task API

Buat landing page secara asinkron dan kueri riwayat tugas.

POST/v2/landing_page

Autentikasi

Bearer API key

Tipe konten

application/json or multipart/form-data

Catatan batas laju

Batas khusus endpoint dapat berlaku.

PPT Task API LiveDoc API

Landing Page Task API menyediakan kemampuan pembuatan landing page secara asinkron. Anda membuat tugas terlebih dahulu, lalu menggunakan kembali API polling tugas yang ada untuk menanyakan progres dan hasil.

Autentikasi

Semua permintaan memerlukan kunci API di header Authorization:

Authorization: Bearer YOUR_API_KEY

Penggunaan dengan Agen AI

Instal paket felo-ai lengkap agar Agen dapat membuat landing page dan menggunakan setiap Felo Skill lain yang tersedia. Penginstal secara dinamis menemukan setiap direktori paket yang berisi SKILL.md, tanpa bergantung pada daftar tetap. Instal semua Skill yang ditemukan di Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills, atau Hermes Agent ~/.hermes/skills. Baca panduan penyiapan Agen AI manual untuk langkah kunci API dan verifikasi khusus platform.

Membuat Tugas Landing Page

Endpoint

POST https://openapi.felo.ai/v2/landing_page

Header Permintaan

Header	Wajib	Deskripsi
`Authorization`	Ya	Kunci API Anda dalam format `Bearer YOUR_API_KEY`
`Content-Type`	Ya	`application/json` atau `multipart/form-data`

Isi Permintaan

Parameter	Tipe	Wajib	Deskripsi
`query`	string	Ya	Prompt permintaan pembuatan landing page
`stream_protocol`	string	Tidak	Protokol stream. Default: `message_center_v1`
`livedoc_short_id`	string	Tidak	ID pendek LiveDoc yang ada untuk digunakan sebagai konteks
`resource_ids`	array string	Tidak	ID resource LiveDoc yang digunakan sebagai konteks

Contoh

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "Generate a landing page for Felo Search"
  }'

Membuat dengan File

Gunakan multipart/form-data untuk mengunggah satu file bersama permintaan tugas Landing Page. File diunggah sebagai resource LiveDoc terlebih dahulu, lalu ID resource-nya diteruskan ke tugas Landing Page.

curl -X POST 'https://openapi.felo.ai/v2/landing_page' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'query=Generate a landing page from this product brief' \
  -F '[email protected]'

Bagian multipart opsional:

Parameter	Tipe	Wajib	Deskripsi
`stream_protocol`	string	Tidak	Protokol stream. Default: `message_center_v1`
`livedoc_short_id`	string	Tidak	ID pendek LiveDoc yang ada. Jika dihilangkan, LiveDoc baru akan dibuat

Respons Berhasil (200)

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019cad6d-e874-55ef-d577-686344b5a7e9"
  }
}

Field Respons

Field	Tipe	Deskripsi
`task_id`	string	Pengenal tugas asinkron untuk polling berikutnya

Menanyakan Status Tugas

Tugas Landing Page menggunakan kembali API polling tugas yang sama seperti tugas PPT.

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/status

Contoh

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Menanyakan Informasi Riwayat Tugas

Endpoint

GET https://openapi.felo.ai/v2/tasks/{task_id}/historical

Contoh

curl -X GET 'https://openapi.felo.ai/v2/tasks/019cad6d-e874-55ef-d577-686344b5a7e9/historical' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Contoh Respons AI_PAGE yang Selesai

{
  "status": "ok",
  "message": null,
  "data": {
    "task_id": "019d7a4d-6ab5-a96d-0f98-43ca434ab621",
    "task_status": "COMPLETED",
    "ppt_biz_id": "9qiLTmT77fA3aVurrMHvRJ",
    "ppt_url": "https://felo.ai/slides/9qiLTmT77fA3aVurrMHvRJ",
    "ai_page_html": "https://felo.ai/ai-page/9qiLTmT77fA3aVurrMHvRJ"
  }
}

Lihat PPT Task API untuk contoh respons polling bersama dan semantik status.

Kode Error

Kode	Status HTTP	Deskripsi
`UNAUTHORIZED`	401	Kunci API tidak valid atau dicabut
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Pembuatan tugas landing page gagal
`INSUFFICIENT_CREDITS`	402	Kredit layanan tidak mencukupi