Felo APIs

Landing Page Task API

Jana landing page secara tak segerak dan pertanyaan sejarah tugas.

POST/v2/landing_page

Pengesahan

Bearer API key

Jenis kandungan

application/json or multipart/form-data

Nota had kadar

Had khusus endpoint mungkin terpakai.

PPT Task API LiveDoc API

Landing Page Task API menyediakan keupayaan penjanaan halaman pendaratan tak segerak. Anda mencipta tugasan terlebih dahulu, kemudian menggunakan semula API tinjauan tugasan sedia ada untuk menanyakan kemajuan dan hasil.

Pengesahan

Semua permintaan memerlukan Kunci API dalam pengepala Authorization:

Authorization: Bearer YOUR_API_KEY

Guna dengan Ejen AI

Pasang pakej lengkap felo-ai untuk membolehkan Ejen menjana halaman pendaratan dan menggunakan setiap Felo Skill lain yang tersedia. Pemasang menemui secara dinamik setiap direktori pakej yang mengandungi SKILL.md, dan bukannya bergantung pada senarai tetap. Pasang semua Skill yang ditemui dalam ~/.codex/skills Codex, ~/.claude/skills Claude Code, ~/.agents/skills OpenClaw, atau ~/.hermes/skills Hermes Agent. Baca panduan persediaan Ejen AI manual untuk langkah kunci API dan pengesahan khusus platform.

Cipta Tugasan Halaman Pendaratan

Endpoint

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

Pengepala Permintaan

Pengepala	Wajib	Penerangan
`Authorization`	Ya	Kunci API anda dalam format `Bearer YOUR_API_KEY`
`Content-Type`	Ya	`application/json` atau `multipart/form-data`

Isi Badan Permintaan

Parameter	Jenis	Wajib	Penerangan
`query`	string	Ya	Gesaan permintaan penjanaan halaman pendaratan
`stream_protocol`	string	Tidak	Protokol strim. Lalai: `message_center_v1`
`livedoc_short_id`	string	Tidak	ID pendek LiveDoc sedia ada untuk digunakan sebagai konteks
`resource_ids`	array of strings	Tidak	ID sumber LiveDoc untuk 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"
  }'

Cipta dengan Fail

Gunakan multipart/form-data untuk memuat naik satu fail bersama permintaan tugasan Halaman Pendaratan. Fail dimuat naik sebagai sumber LiveDoc terlebih dahulu, kemudian ID sumbernya dihantar kepada tugasan Halaman Pendaratan.

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]'

Bahagian multipart pilihan:

Parameter	Jenis	Wajib	Penerangan
`stream_protocol`	string	Tidak	Protokol strim. Lalai: `message_center_v1`
`livedoc_short_id`	string	Tidak	ID pendek LiveDoc sedia ada. Jika ditinggalkan, LiveDoc baharu dicipta

Respons Berjaya (200)

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

Medan Respons

Medan	Jenis	Penerangan
`task_id`	string	Pengecam tugasan tak segerak untuk tinjauan seterusnya

Tinjau Status Tugasan

Tugasan Halaman Pendaratan menggunakan semula API tinjauan tugasan yang sama seperti tugasan 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'

Tanyakan Maklumat Sejarah Tugasan

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 Selesai AI_PAGE

{
  "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"
  }
}

Rujuk PPT Task API untuk contoh respons tinjauan yang dikongsi dan semantik status.

Kod Ralat

Kod	Status HTTP	Penerangan
`UNAUTHORIZED`	401	Kunci API tidak sah atau telah dibatalkan
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Penciptaan tugasan halaman pendaratan gagal
`INSUFFICIENT_CREDITS`	402	Kredit tidak mencukupi