Felo API PlatformFelo API Platform

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

Provider: 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"

5. โพลการส่งออกและดาวน์โหลด

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"
สถานะการดำเนินการถัดไป
NOT_STARTEDส่งการส่งออกหนึ่งครั้ง
PROCESSINGรอ แล้วโพล GET อีกครั้ง
COMPLETEDอ่าน download_url และดาวน์โหลดไฟล์
FAILEDตรวจสอบข้อผิดพลาดและสถานะ task ก่อนส่งการส่งออกใหม่
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

URL ตัวอย่างมีไว้เพื่อประกอบการอธิบาย ใช้ signed URL จริงจาก response มันใช้ได้ 30 นาที; สถานะการส่งออก GET อาจส่งคืนลิงก์ใหม่ในขณะที่งานนำเสนอยังคงพร้อมใช้งาน บันทึกไฟล์ภายในอายุการใช้งานของมัน อย่าส่ง Felo API key ของคุณไปยังโฮสต์ดาวน์โหลดไฟล์

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

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

ต้องการความช่วยเหลือไหม