# Результаты генерации Felo

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

Генерируйте презентацию асинхронно, затем экспортируйте файл PPTX. Разделяйте шаги генерации и экспорта: созданная задача — это еще не готовый файл.

Во всех примерах используется `FELO_API_KEY` из [обзора](https://openapi.felo.ai/ru/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/ru/docs/data-api/guides/felo-billing.md).