Felo API PlatformFelo API Platform

Felo Exportstatus

Anbieter: Felo · Bezahlt mit Plattform-Guthaben

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

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Export abfragen und herunterladen

GET /api/v1/data/ppts/{business_id}/export

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
StatusNächste Aktion
NOT_STARTEDSende den Export einmal ab
PROCESSINGWarte und frage dann erneut per GET ab
COMPLETEDLies download_url und lade die Datei herunter
FAILEDPrüfe den Fehler und den Aufgabenstatus, bevor du einen neuen Export absendest
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

Die Beispiel-URL dient nur zur Veranschaulichung. Verwende die tatsächliche signierte URL aus der Antwort. Sie ist 30 Minuten gültig; der GET-Exportstatus kann einen frischen Link zurückgeben, solange die Präsentation verfügbar bleibt. Speichere die Datei innerhalb ihrer Lebensdauer. Sende deinen Felo API-Schlüssel nicht an den Datei-Download-Host.

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.

Brauchst du Hilfe?