สถานะการสร้างของ Felo

สร้างงานนำเสนอแบบอะซิงโครนัส แล้วจึงส่งออกเป็นไฟล์ PPTX แยกขั้นตอนการสร้างและการส่งออกออกจากกัน: task ที่สร้างแล้วไม่ใช่ไฟล์ที่เสร็จสมบูรณ์

ตัวอย่างทั้งหมดใช้ FELO_API_KEY จาก ภาพรวม การเรียกใช้ใช้ ยอดคงเหลือบนแพลตฟอร์ม ไม่ใช่ Felo Pro credits ตัวอย่างการตอบกลับมีไว้เพื่อประกอบการอธิบาย; เนื้อหาจริงและฟิลด์เสริมอาจแตกต่างกัน

ใช้ตัวระบุที่ส่งคืนเมื่อสร้าง task ตั้งค่า TASK_ID เป็น task_id และ PPT_ID เป็น ppt_business_id; {business_id} หมายถึง ppt_business_id ด้วย.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. โพลสถานะการสร้าง

GET /api/v1/data/tasks/{task_id}/status

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/status" \
  -H "Authorization: Bearer $FELO_API_KEY"

response มีสตริง status ที่ราก เช่น RUNNING หรือ COMPLETED โพลด้วยช่วงเวลาที่จำกัด (เช่น 2–5 วินาที) และกำหนดเส้นตาย ดำเนินต่อไปยังผลลัพธ์หลังเสร็จสิ้น จัดการความล้มเหลวและสถานะที่ไม่คาดคิดโดยไม่สรุปว่าประสบความสำเร็จ เส้นตายของการโพลไม่ได้ยกเลิก task

{"status":"COMPLETED"}

อายุการใช้งาน ความเป็นเจ้าของ และการเรียกเก็บเงิน

• งานนำเสนอหมดอายุ เจ็ดวันหลังการสร้าง คำถามและการส่งออกไม่ได้ขยายช่วงเวลานี้ expires_at ของงานนำเสนอและ expires_at ของ signed download URL เป็นอายุการใช้งานคนละแบบกัน
• มีเพียงบัญชี API ที่สร้างเท่านั้นที่เข้าถึง tasks และงานนำเสนอของมันได้ ทรัพยากรที่หายไปหรือเข้าถึงไม่ได้อาจส่งกลับ 404; ทรัพยากรที่หมดอายุหรือลบแล้วอาจส่งกลับ 410 หรือ 404 หลังการล้างข้อมูล
• การสร้างคิดค่าบริการต่อหน้าที่สร้าง (ppt.generate) ภายใต้การคิดค่าบริการตามหน้า การสร้างจะกันวงเงินเท่ากับราคาของสิบหน้า จากนั้นชำระตามผลลัพธ์ที่สร้างจริงและปล่อยวงเงินที่กันไว้แต่ไม่ได้ใช้ บัญชีของคุณต้องมีวงเงินที่พร้อมใช้เพียงพอสำหรับการกันวงเงิน แม้ prompt จะขอหน้าจำนวนน้อยกว่าก็ตาม
• การส่งออกมีราคาคำขอแยกต่างหาก (ppt.export) คำขอสถานะ คำขอผลลัพธ์ คำขอสถานะการส่งออก และการลบ ไม่สร้างการคิดค่าบริการใหม่
• หลัง timeout ให้โพล task ที่บันทึกไว้แทนการสร้างงานนำเสนออีกอัน ดู Billing and Errors