Felo API PlatformFelo API Platform

Felo Status eksportu

Dostawca: Felo · Płatność z salda platformy

Uwierzytelnianie i konfiguracjaRozliczenia i błędyPełny przewodnik po przepływie pracy

Wygeneruj prezentację asynchronicznie, a następnie wyeksportuj plik PPTX. Rozdziel krok generowania i eksportu: utworzone zadanie nie jest jeszcze gotowym plikiem.

Wszystkie przykłady używają FELO_API_KEY z przeglądu. Wywołania korzystają z salda platformy, a nie z kredytów Felo Pro. Przykłady odpowiedzi mają charakter poglądowy; rzeczywista treść i opcjonalne pola mogą się różnić.

Użyj identyfikatorów zwróconych podczas tworzenia zadania. Ustaw TASK_ID na task_id i PPT_ID na ppt_business_id; {business_id} oznacza również ppt_business_id.

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. Sprawdzaj eksport i pobierz plik

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"
StatusNastępna czynność
NOT_STARTEDWyślij eksport raz
PROCESSINGPoczekaj, a następnie ponownie odpytaj GET
COMPLETEDOdczytaj download_url i pobierz plik
FAILEDSprawdź błąd i stan zadania przed wysłaniem nowego eksportu
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

Przykładowy URL ma charakter poglądowy. Użyj rzeczywistego podpisanego URL z odpowiedzi. Jest ważny przez 30 minut; status eksportu GET może zwrócić świeży link, dopóki prezentacja pozostaje dostępna. Zapisz plik w czasie jego ważności. Nie wysyłaj klucza Felo API do hosta pobierania pliku.

Czas życia, własność i rozliczenia

  • Prezentacje wygasają siedem dni po utworzeniu. Zapytania i eksporty nie wydłużają tego okresu. expires_at prezentacji i podpisany URL pobierania expires_at opisują różne czasy życia.
  • Tylko konto API, które utworzyło zasób, może uzyskiwać dostęp do swoich zadań i prezentacji. Brakujący lub niedostępny zasób może zwrócić 404; wygasły lub usunięty zasób może zwrócić 410 albo 404 po sprzątaniu.
  • Generowanie jest rozliczane za wygenerowaną stronę (ppt.generate). Przy cenach per strona utworzenie rezerwuje cenę dziesięciu stron, a następnie rozlicza rzeczywisty udany wynik i zwalnia niewykorzystaną rezerwację. Twoje konto potrzebuje wystarczającego dostępnego salda na rezerwację, nawet jeśli prompt prosi o mniej stron.
  • Eksport ma osobną cenę za żądanie (ppt.export). Zapytania o status, zapytania o wyniki, zapytania o status eksportu i usuwanie nie tworzą nowej opłaty.
  • Po przekroczeniu limitu czasu sprawdź zapisane zadanie, zamiast tworzyć kolejną prezentację. Zobacz Rozliczenia i błędy.

Potrzebujesz pomocy?