Felo APIs

Landing Page Task API

Tạo landing page bất đồng bộ và truy vấn lịch sử tác vụ.

POST/v2/landing_page

Xác thực

Bearer API key

Loại nội dung

application/json or multipart/form-data

Ghi chú về giới hạn

Có thể áp dụng giới hạn riêng cho endpoint.

PPT Task API LiveDoc API

Landing Page Task API cung cấp khả năng tạo landing page bất đồng bộ. Bạn tạo tác vụ trước, sau đó dùng lại các API thăm dò tác vụ hiện có để truy vấn tiến độ và kết quả.

Xác thực

Mọi yêu cầu đều cần khóa API trong header Authorization:

Authorization: Bearer YOUR_API_KEY

Dùng với AI Agent

Cài gói felo-ai đầy đủ để một Agent có thể tạo landing page và sử dụng mọi Felo Skill khác hiện có. Trình cài đặt tự động khám phá mọi thư mục gói có chứa SKILL.md, thay vì dựa vào một danh sách cố định. Hãy cài mọi Skill được phát hiện vào Codex ~/.codex/skills, Claude Code ~/.claude/skills, OpenClaw ~/.agents/skills hoặc Hermes Agent ~/.hermes/skills. Đọc hướng dẫn thiết lập AI Agent thủ công để biết các bước cấu hình khóa API và xác minh riêng cho từng nền tảng.

Tạo tác vụ Landing Page

Endpoint

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

Header yêu cầu

Header	Bắt buộc	Mô tả
`Authorization`	Có	Khóa API của bạn theo định dạng `Bearer YOUR_API_KEY`
`Content-Type`	Có	`application/json` hoặc `multipart/form-data`

Nội dung yêu cầu

Tham số	Kiểu	Bắt buộc	Mô tả
`query`	string	Có	Câu lệnh yêu cầu tạo landing page
`stream_protocol`	string	Không	Giao thức luồng. Mặc định: `message_center_v1`
`livedoc_short_id`	string	Không	Short ID của LiveDoc hiện có để dùng làm ngữ cảnh
`resource_ids`	array of strings	Không	Các ID tài nguyên LiveDoc để dùng làm ngữ cảnh

Ví dụ

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

Tạo với tệp

Dùng multipart/form-data để tải một tệp lên cùng yêu cầu tác vụ Landing Page. Tệp được tải lên thành tài nguyên LiveDoc trước, sau đó resource ID của nó được truyền cho tác vụ 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]'

Các phần multipart tùy chọn:

Tham số	Kiểu	Bắt buộc	Mô tả
`stream_protocol`	string	Không	Giao thức luồng. Mặc định: `message_center_v1`
`livedoc_short_id`	string	Không	Short ID của LiveDoc hiện có. Nếu bỏ qua, một LiveDoc mới sẽ được tạo

Phản hồi thành công (200)

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

Các trường phản hồi

Trường	Kiểu	Mô tả
`task_id`	string	Định danh tác vụ bất đồng bộ dùng cho các lần thăm dò tiếp theo

Thăm dò trạng thái tác vụ

Tác vụ Landing Page dùng lại cùng các API thăm dò tác vụ như tác vụ PPT.

Endpoint

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

Ví dụ

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'

Truy vấn thông tin lịch sử của tác vụ

Endpoint

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

Ví dụ

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'

Ví dụ phản hồi AI_PAGE đã hoàn tất

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

Tham khảo PPT Task API để xem các ví dụ phản hồi thăm dò dùng chung và ngữ nghĩa trạng thái.

Mã lỗi

Mã	Trạng thái HTTP	Mô tả
`UNAUTHORIZED`	401	Khóa API không hợp lệ hoặc đã bị thu hồi
`LANDING_PAGE_TASK_CREATE_FAILED`	502	Tạo tác vụ landing page thất bại
`INSUFFICIENT_CREDITS`	402	Không đủ tín dụng khả dụng