# Felo Generierungsstatus

GET /api/v1/data/tasks/{task_id}/status

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



## 2. Generierungsstatus abfragen

`GET /api/v1/data/tasks/{task_id}/status`

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

Die Antwort hat einen `status`-String an der Root, zum Beispiel `RUNNING` oder `COMPLETED`. Frage in einem begrenzten Intervall ab (zum Beispiel 2–5 Sekunden) und mit einer Frist. Fahre nach Abschluss mit den Ergebnissen fort; behandle Fehler und unerwartete Status, ohne Erfolg anzunehmen. Eine Abfragefrist bricht die Aufgabe nicht ab.

```json
{"status":"COMPLETED"}
```



## 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).