Skip to main content

Felo PPT API giờ xuất được tệp PPTX thật

· 9 phút đọc
Felo Search Tips Buddy
Felo Search Tips Buddy
Committed to answers at your fingertips

API Nhiệm vụ PPT của Felo OpenAPI giờ có thể xuất các bộ slide đã tạo dưới dạng tệp .pptx có thể chỉnh sửa. Một khóa API, quy trình bất đồng bộ bốn bước, và một liên kết tải về.

Agent của bạn có thể nghiên cứu chủ đề, xây dựng dàn ý, và tạo bộ slide hoàn chỉnh mà bạn không cần động đến công cụ thiết kế. Điều còn thiếu là tệp mà nhóm của bạn có thể mở bằng PowerPoint.

Khoảng cách đó đã được lấp đầy. Felo OpenAPI giờ xuất các bộ slide đã tạo dưới dạng tệp .pptx thật. API Nhiệm vụ PPT đã tạo slide có thể chỉnh sửa trong Felo; các endpoint xuất mới chuyển chúng thành tệp PowerPoint để bạn tải về, chỉnh sửa, và chia sẻ. Vẫn một khóa API, vẫn quy trình bất đồng bộ, chỉ thêm một lần gọi.

Thử ngay: https://openapi.felo.ai/docs/api-reference/ppt-tasks

Felo PPT Task API giờ xuất được tệp .pptx thật: nghiên cứu đến bộ slide trong một quy trình, POST /v2/ppts/{id}/export, download_url hợp lệ 30 phút

Thay đổi thực sự là gì​

Trước bản cập nhật này, API Nhiệm vụ PPT kết thúc ở một URL slide Felo. Bạn nhận được bộ slide, nhưng việc bàn giao dừng lại ở đó: để trình bày cho khách hàng, lớp học, hoặc hội đồng, ai đó phải dựng lại slide bằng tay trong PowerPoint.

Giờ quy trình hoàn tất. Khi nhiệm vụ tạo PPT đạt trạng thái COMPLETED, bạn gọi một endpoint xuất và kiểm tra một endpoint khác. API trả về một download_url đã ký dẫn đến tệp .pptx thật — bộ slide đó, ở định dạng mọi người đã dùng.

Hai điểm khiến điều này hơn một chuyển đổi định dạng:

  • Bộ slide có thể chỉnh sửa. Không phải PDF, không phải tập hợp ảnh phẳng. Văn bản, bố cục, và cấu trúc chủ đề giữ nguyên khi chuyển sang PowerPoint, đồng nghiệp có thể sửa số liệu hoặc sắp xếp lại mục mà không cần tạo lại.
  • Nghiên cứu đã hoàn thành. Việc tạo PPT của Felo không chỉ đổ prompt lên slide. Nó nghiên cứu chủ đề, thu thập nguồn, cấu trúc lập luận, và áp dụng chủ đề. Bạn nhận được bộ slide sẵn sàng trình bày, không phải bản nháp cần viết lại.

Đó là điểm mấu chốt. Hầu hết công cụ hoặc nghiên cứu tốt và trả về văn bản, hoặc định dạng tốt và trả về cấu trúc rỗng. Felo làm cả hai, và giờ gửi kết quả dưới dạng tệp.

Quy trình xuất hoạt động thế nào​

Việc xuất diễn ra bất đồng bộ, giống các API Nhiệm vụ PPT khác. Bạn gửi một job, kiểm tra đến khi hoàn thành, và tải về kết quả.

Bước 1 — Tạo bộ slide​

Tạo nhiệm vụ PPT với một prompt. Nếu muốn giao diện cụ thể, liệt kê các chủ đề có sẵn trước và truyền theme ID.

POST https://openapi.felo.ai/v2/ppts
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "query": "Q3 competitive landscape review, 12 pages",
  "ppt_config": {
    "ai_theme_id": "02968979-a69f-42c4-b136-de02c40ab2d7"
  }
}

Phản hồi trả về task_id và ppt_business_id. Giữ cả hai — bạn cần task ID để kiểm tra tiến trình tạo, và business ID để xuất.

Bước 2 — Kiểm tra đến khi bộ slide sẵn sàng​

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

Kiểm tra mỗi 2–5 giây. Khi task_status là COMPLETED, bộ slide đã có và bạn có thể xuất. Một ppt_url trả về kèm nếu bạn muốn xem trước slide trong Felo.

Bước 3 — Gửi yêu cầu xuất​

POST https://openapi.felo.ai/v2/ppts/YOUR_PPT_BUSINESS_ID/export
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{}

Đó là toàn bộ request body: {}. Việc xuất chạy như một job nền.

Bước 4 — Kiểm tra tiến trình xuất và tải về​

GET https://openapi.felo.ai/v2/ppts/{ppt_business_id}/export
Authorization: Bearer YOUR_API_KEY

Kiểm tra mỗi 2–5 giây. data.status chuyển qua NOT_STARTED, PROCESSING, và COMPLETED. Chỉ COMPLETED trả về payload bạn cần:

{
  "status": "ok",
  "message": null,
  "data": {
    "status": "COMPLETED",
    "download_url": "https://example.com/presentation.pptx?signature=...",
    "expires_at": "2026-09-29T10:30:00Z"
  }
}

Tải tệp từ download_url và bạn đã xong.

Quy trình xuất PPTX: POST /v2/ppts tạo bộ slide, GET /v2/tasks/{task_id}/historical kiểm tra đến khi COMPLETED, POST /v2/ppts/{id}/export bắt đầu xuất, GET /v2/ppts/{id}/export trả về download_url hợp lệ 30 phút

Bốn chi tiết cần biết trước khi triển khai​

Download URL hết hạn sau 30 phút. Đây là URL đã ký, không phải liên kết vĩnh viễn. Nếu hết hạn, gọi lại endpoint GET export — endpoint này cấp URL mới mà không tạo lại PPTX, nên không tốn phí.

Xuất lại sau khi hoàn thành tốn một credit. Gọi lại POST khi xuất vẫn đang xử lý thì an toàn và không tạo job thứ hai. Nhưng gọi POST sau khi xuất đã xong sẽ tạo lại tệp và trừ credit xuất PPT hiện có. Nếu chỉ cần liên kết mới, dùng GET.

Khóa API phải sở hữu bộ slide. Việc xuất chỉ dành cho khóa đã tạo PPT. Khóa không tạo bộ slide không thể xuất, giúp giữ bộ slide trong tài khoản đã tạo.

Lỗi có thể thử lại. Xuất FAILED có thể gửi lại bằng POST. Thiếu credit trả về HTTP 402; giới hạn tốc độ trả về HTTP 429 và nên thử lại sau một thời gian ngắn.

Tại sao điều này quan trọng với agent​

Điểm thú vị không nằm ở định dạng tệp. Nó nằm ở quy trình nghiên cứu đến tệp hoàn chỉnh mà quy trình này mở ra.

Agent có thể nghiên cứu và xuất tệp giờ chạy được toàn bộ vòng lặp mà không cần giám sát:

  • Báo cáo kinh doanh hàng tuần — lấy số liệu tuần, nghiên cứu bối cảnh, tạo bộ slide, xuất tệp, và đặt .pptx vào ổ chia sẻ trước buổi họp thứ Hai.
  • Tài liệu cho khách hàng — chuyển brief thành bộ slide có nguồn, chủ đề và bàn giao tệp chỉnh sửa được để khách tự gắn thương hiệu.
  • Hỗ trợ bán hàng — tạo bộ slide riêng cho từng khách hàng từ nghiên cứu tài khoản, xuất từng tệp, và đính kèm vào hồ sơ CRM tự động.
  • Tài liệu khóa học và đào tạo — nghiên cứu chủ đề, cấu trúc thành bài học, xuất slide để giảng viên chỉnh sửa trước giờ lên lớp.

Ở mỗi trường hợp, công việc của con người chỉ còn lại việc xem xét và hoàn thiện. Không ai bắt đầu từ slide trắng.

Nếu bạn không muốn tự viết vòng lặp kiểm tra, Felo PPT Skill đã xử lý. Cài đặt gói agent Felo AI, agent của bạn có thể tạo, kiểm tra, và xuất slide như một năng lực duy nhất — quy trình trên được đóng gói để agent gọi trực tiếp.

Bắt đầu​

Xuất đã có trên API Nhiệm vụ PPT, dành cho mọi khóa Felo OpenAPI.

  1. Lấy khóa API từ dashboard Felo OpenAPI.
  2. Đọc tài liệu API Nhiệm vụ PPT — phần Export PPTX có mẫu request và response chính xác.
  3. Tạo bộ slide, xuất, và mở tệp bằng PowerPoint.

Nếu muốn nhanh hơn, cài đặt Felo PPT Skill và để agent chạy toàn bộ quy trình.

Bắt đầu xây dựng với Felo OpenAPI: https://openapi.felo.ai

Câu hỏi thường gặp​

Tệp xuất ra có chỉnh sửa được trong PowerPoint không? Có. Việc xuất tạo tệp .pptx chuẩn. Văn bản, bố cục, và cấu trúc chủ đề giữ nguyên, nên bộ slide chỉnh sửa được trong PowerPoint, Google Slides, hoặc Keynote.

Xuất có tốn thêm phí không? Gửi yêu cầu xuất sau khi tạo bộ slide dùng credit xuất PPT hiện có. Thiếu credit trả về HTTP 402. Lấy liên kết tải về mới bằng GET không tạo lại tệp và không tính phí.

Liên kết tải về có hiệu lực bao lâu? 30 phút từ khi cấp. Gọi lại endpoint GET export để lấy liên kết mới.

Có thể xuất bộ slide tạo bằng khóa API khác không? Không. Khóa API gửi yêu cầu xuất phải sở hữu PPT.

Nếu xuất thất bại thì sao? data.status trả về FAILED. Gửi lại yêu cầu POST export để thử lại.

Bài viết này cũng có sẵn bằng English, 简体中文, 日本語, 한국어, 繁體中文, हिन्दी, Français, العربية, Русский, اردو, Bahasa Indonesia, Deutsch, Türkçe, Italiano, ไทย, Español, বাংলা and Português.