# Felo Generierungsergebnisse

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

Erzeuge eine Präsentation asynchron und exportiere dann eine PPTX-Datei. Halte Generierung und Export getrennt: Eine erstellte Aufgabe ist noch keine fertige Datei.

Alle Beispiele verwenden `FELO_API_KEY` aus der [Übersicht](https://openapi.felo.ai/de/docs/data-api/guides/felo-overview.md). Aufrufe verwenden **Plattform-Guthaben**, nicht Felo-Pro-Guthaben. Antwortbeispiele sind illustrativ; Live-Inhalte und optionale Felder variieren.



Verwende die Kennungen, die bei der Erstellung der Aufgabe zurückgegeben werden. Setze `TASK_ID` auf `task_id` und `PPT_ID` auf `ppt_business_id`; `{business_id}` bedeutet ebenfalls `ppt_business_id`.

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



## 3. Generierungsergebnisse lesen

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

Dies ist ein **POST**, ohne erforderlichen 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
}
```

Lies `task_status`, bevor du `history_data` verwendest. Die History-Payload kann je nach Aufgabe variieren und kann null sein. `ai_page_html` und `thread_short_id` sind optional. Diese Antwort ist keine garantierte PPTX-Download-URL; verwende als Nächstes den Export.



## Lebensdauer, Besitz und Abrechnung

- Präsentationen laufen **sieben Tage nach der Erstellung** ab. Abfragen und Exporte verlängern diesen Zeitraum nicht. Die `expires_at`-Angabe der Präsentation und die `expires_at`-Angabe der signierten Download-URL beschreiben unterschiedliche Lebensdauern.
- Nur das erstellende API-Konto kann auf seine Aufgaben und Präsentationen zugreifen. Eine fehlende oder nicht zugängliche Ressource kann 404 zurückgeben; eine abgelaufene oder gelöschte Ressource kann 410 zurückgeben, oder nach der Bereinigung 404.
- Die Generierung wird pro generierter Seite (`ppt.generate`) abgerechnet. Bei der Seitenpreis-Abrechnung reserviert die Erstellung den Preis von zehn Seiten, rechnet dann die tatsächlich erfolgreiche Ausgabe ab und gibt die ungenutzte Reservierung frei. Dein Konto benötigt genug verfügbares Guthaben für die Reservierung, auch wenn der Prompt weniger Seiten anfordert.
- Der Export hat einen separaten Anfragepreis (`ppt.export`). Statusabfragen, Ergebnisabfragen, Exportstatusabfragen und Löschung verursachen keine neue Gebühr.
- Frage nach einem Timeout die gespeicherte Aufgabe ab, statt eine weitere Präsentation zu erstellen. Siehe [Abrechnung und Fehler](https://openapi.felo.ai/de/docs/data-api/guides/felo-billing.md).