Felo API PlatformFelo API Platform

Trạng thái xuất Felo

Nhà cung cấp: Felo · Thanh toán bằng số dư nền tảng

Xác thực & thiết lậpThanh toán & lỗiHướng dẫn quy trình đầy đủ

Tạo một bản trình bày không đồng bộ, rồi xuất tệp PPTX. Giữ các bước tạo và xuất tách biệt: một tác vụ đã tạo chưa phải là một tệp hoàn chỉnh.

Tất cả ví dụ dùng FELO_API_KEY từ tổng quan. Các cuộc gọi sử dụng số dư nền tảng, không phải tín dụng Felo Pro. Các ví dụ phản hồi chỉ mang tính minh họa; nội dung thực tế và các trường tùy chọn sẽ thay đổi.

Sử dụng các định danh được trả về khi tạo tác vụ. Đặt TASK_ID thành task_id và PPT_ID thành ppt_business_id; {business_id} cũng có nghĩa là ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Thăm dò xuất và tải xuống

GET /api/v1/data/ppts/{business_id}/export

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
Trạng tháiHành động tiếp theo
NOT_STARTEDGửi xuất một lần
PROCESSINGChờ, rồi thăm dò GET lại
COMPLETEDĐọc download_url và tải tệp xuống
FAILEDKiểm tra lỗi và trạng thái tác vụ trước khi gửi một lần xuất mới
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

URL ví dụ chỉ mang tính minh họa. Hãy dùng URL có ký số thực tế từ phản hồi. Nó có hiệu lực trong 30 phút; trạng thái xuất GET có thể trả về một liên kết mới trong khi bản trình bày vẫn còn khả dụng. Hãy lưu tệp trong thời hạn đó. Không gửi khóa Felo API của bạn tới máy chủ tải tệp.

Vòng đời, quyền sở hữu và thanh toán

  • Bản trình bày hết hạn bảy ngày sau khi tạo. Các truy vấn và xuất không kéo dài khoảng thời gian này. expires_at của bản trình bày và expires_at của URL tải xuống có chữ ký mô tả các vòng đời khác nhau.
  • Chỉ tài khoản API đã tạo mới có thể truy cập các tác vụ và bản trình bày của nó. Một tài nguyên bị thiếu hoặc không thể truy cập có thể trả về 404; một tài nguyên đã hết hạn hoặc đã bị xóa có thể trả về 410, hoặc 404 sau khi dọn dẹp.
  • Việc tạo được tính phí theo từng trang được tạo (ppt.generate). Theo định giá theo trang, khi tạo sẽ giữ chỗ cho giá của mười trang, rồi quyết toán đầu ra thành công thực tế và giải phóng phần giữ chỗ chưa dùng. Tài khoản của bạn cần đủ số dư khả dụng cho khoản giữ chỗ ngay cả khi prompt yêu cầu ít trang hơn.
  • Xuất có một mức giá yêu cầu riêng (ppt.export). Các truy vấn trạng thái, truy vấn kết quả, truy vấn trạng thái xuất và thao tác xóa không tạo ra phí mới.
  • Sau khi timeout, hãy truy vấn tác vụ đã lưu thay vì tạo một bản trình bày khác. Xem Thanh toán và Lỗi.

Cần trợ giúp?