Felo जनरेशन स्थिति

एक प्रस्तुति को asynchronously generate करें, फिर एक PPTX file export करें। Generation और export steps को अलग रखें: created task अभी finished file नहीं होती।

सभी examples overview से FELO_API_KEY का उपयोग करते हैं। Calls platform balance का उपयोग करती हैं, Felo Pro credits का नहीं। Response examples केवल illustrative हैं; live content और optional fields बदलते रहते हैं।

Task बनाते समय लौटाए गए identifiers का उपयोग करें। TASK_ID को task_id और PPT_ID को ppt_business_id पर सेट करें; {business_id} का अर्थ भी ppt_business_id है।

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

2. जनरेशन स्थिति पोल करें

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

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

Response में root status string होती है, उदाहरण के लिए RUNNING या COMPLETED। Bounded interval (उदाहरण के लिए, 2–5 seconds) और एक deadline के साथ poll करें। Completion के बाद results पर जाएँ; success मान लेने के बजाय failure और unexpected statuses को handle करें। Polling deadline task को cancel नहीं करती।

{"status":"COMPLETED"}

अवधि, स्वामित्व और बिलिंग

• प्रस्तुतियाँ creation के सात दिन बाद expire हो जाती हैं। Queries और exports इस अवधि को extend नहीं करते। Presentation expires_at और signed download URL expires_at अलग lifetimes का वर्णन करते हैं।
• केवल बनाने वाला API account ही अपनी tasks और presentations access कर सकता है। Missing या inaccessible resource पर 404 लौट सकता है; expired या deleted resource पर 410, या cleanup के बाद 404 लौट सकता है।
• Generation का बिल प्रति generated page (ppt.generate) लगता है। Page pricing के अंतर्गत, creation दस pages की कीमत reserve करती है, फिर actual successful output के अनुसार settlement करती है और unused reservation release करती है। यदि prompt में कम pages माँगे गए हों तब भी आपके account में reservation के लिए पर्याप्त available balance होना चाहिए।
• Export की अलग request price (ppt.export) है। Status queries, result queries, export-status queries और deletion कोई नया charge create नहीं करते।
• Timeout के बाद, दूसरी प्रस्तुति बनाने के बजाय saved task को query करें। Billing and Errors देखें।