# Felo Результати створення презентації

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

Генеруйте презентацію асинхронно, а потім експортуйте файл PPTX. Тримайте кроки генерації та експорту окремо: створене завдання ще не є готовим файлом.

У всіх прикладах використовується `FELO_API_KEY` з [огляду](https://openapi.felo.ai/uk/docs/data-api/guides/felo-overview.md). Виклики використовують **баланс платформи**, а не кредити Felo Pro. Приклади відповідей є ілюстративними; живий контент і необов’язкові поля можуть відрізнятися.



Використовуйте ідентифікатори, повернуті під час створення завдання. Встановіть `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.

```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
}
```

Читайте `task_status` перед використанням `history_data`. Корисне навантаження історії може відрізнятися залежно від завдання і може бути null. `ai_page_html` і `thread_short_id` є необов’язковими. Ця відповідь не є гарантованим URL для завантаження PPTX; далі використовуйте експорт.



## Життєвий цикл, право доступу та білінг

- Презентації закінчують термін дії **через сім днів після створення**. Запити та експорти не подовжують цей період. `expires_at` презентації та `expires_at` підписаного URL для завантаження описують різні терміни дії.
- Доступ до своїх завдань і презентацій має лише той API-обліковий запис, який їх створив. Відсутній або недоступний ресурс може повертати 404; ресурс із закінченим терміном дії або видалений ресурс може повертати 410, або 404 після очищення.
- Генерація оплачується за згенеровану сторінку (`ppt.generate`). За ціною сторінки створення резервує ціну десяти сторінок, потім проводить розрахунок за фактично успішний вихід і звільняє невикористаний резерв. Вашому обліковому запису потрібно мати достатньо доступного балансу для резервування, навіть якщо запит передбачає менше сторінок.
- Експорт має окрему ціну за запит (`ppt.export`). Запити статусу, запити результатів, запити статусу експорту та видалення не створюють нового списання.
- Після тайм-ауту запитуйте збережене завдання, а не створюйте ще одну презентацію. Дивіться [Білінг і помилки](https://openapi.felo.ai/uk/docs/data-api/guides/felo-billing.md).