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

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

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

ตัวอย่างทั้งหมดใช้ `FELO_API_KEY` จาก [ภาพรวม](https://openapi.felo.ai/th/docs/data-api/guides/felo-overview.md) การเรียกใช้ใช้ **ยอดคงเหลือบนแพลตฟอร์ม** ไม่ใช่ Felo Pro credits ตัวอย่างการตอบกลับมีไว้เพื่อประกอบการอธิบาย; เนื้อหาจริงและฟิลด์เสริมอาจแตกต่างกัน



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

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



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

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

```bash
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 ก่อนส่งการส่งออกใหม่ |

```json
{
  "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](https://openapi.felo.ai/th/docs/data-api/guides/felo-billing.md)