# Felo جنریشن نتائج

POST /api/v1/data/tasks/{task_id}/historical

ایک presentation کو asynchronous طور پر generate کریں، پھر ایک PPTX file ایکسپورٹ کریں۔ generation اور export steps کو الگ رکھیں: create کیا گیا task ابھی مکمل file نہیں ہوتا۔

تمام examples، [overview](https://openapi.felo.ai/ur/docs/data-api/guides/felo-overview.md) سے `FELO_API_KEY` استعمال کرتے ہیں۔ Calls **platform balance** استعمال کرتی ہیں، Felo Pro credits نہیں۔ Response examples صرف وضاحتی ہیں؛ live content اور optional fields مختلف ہو سکتے ہیں۔



task بناتے وقت واپس آنے والے identifiers استعمال کریں۔ `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"
```



## 3. بنانے کے نتائج پڑھیں

`POST /api/v1/data/tasks/{task_id}/historical`

یہ **POST** ہے، اور کسی JSON body کی ضرورت نہیں۔

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/historical" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

```json
{
  "task_id":"example-task-id",
  "task_status":"COMPLETED",
  "history_data":{},
  "error_message":null
}
```

`history_data` استعمال کرنے سے پہلے `task_status` پڑھیں۔ history payload task کے مطابق مختلف ہو سکتی ہے اور null بھی ہو سکتی ہے۔ `ai_page_html` اور `thread_short_id` optional ہیں۔ یہ response guaranteed PPTX download URL نہیں ہے؛ اگلا مرحلہ export ہے۔



## مدت، ملکیت اور بلنگ

- Presentations **creation کے سات دن بعد** expire ہو جاتی ہیں۔ queries اور exports اس مدت میں توسیع نہیں کرتے۔ presentation `expires_at` اور signed download URL `expires_at` مختلف lifetimes کو بیان کرتے ہیں۔
- صرف creating API account اپنی tasks اور presentations تک رسائی حاصل کر سکتا ہے۔ missing یا inaccessible resource، 404 واپس کر سکتی ہے؛ expired یا deleted resource، 410، یا cleanup کے بعد 404 واپس کر سکتی ہے۔
- Generation کی بلنگ فی generated page (`ppt.generate`) ہوتی ہے۔ page pricing کے تحت، creation دس pages کی قیمت reserve کرتی ہے، پھر اصل successful output کے مطابق settlement ہوتی ہے اور غیر استعمال شدہ reservation release کر دی جاتی ہے۔ آپ کے account میں reservation کے لیے کافی available balance ہونا چاہیے چاہے prompt میں کم pages مانگے گئے ہوں۔
- Export کی الگ request price (`ppt.export`) ہے۔ Status queries، result queries، export-status queries اور deletion کوئی نئی charge پیدا نہیں کرتے۔
- timeout کے بعد، دوسری presentation بنانے کے بجائے محفوظ شدہ task query کریں۔ [Billing and Errors](https://openapi.felo.ai/ur/docs/data-api/guides/felo-billing.md) دیکھیں۔