PPT जनरेशन और निर्यात

एक प्रस्तुति को 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 बदलते रहते हैं।

कार्यप्रवाह और पहचानकर्ता

1. एक generation task बनाएँ; task_id, ppt_business_id और expires_at save करें।
2. task_id का उपयोग करके generation status poll करें।
3. task_id का उपयोग करके generation results पढ़ें।
4. ppt_business_id का उपयोग करके PPTX export शुरू करें।
5. Export status poll करें और completed file download करें।
6. वैकल्पिक रूप से प्रस्तुति को जल्दी delete करें।

Route placeholders में {business_id} का अर्थ लौटाया गया `ppt_business_id` है, task_id, resource_id या livedoc_short_id नहीं। पूरे workflow के लिए वही API account उपयोग करें। Examples में IDs placeholders हैं।

1. प्रस्तुति बनाएँ

POST /api/v1/data/ppts

पहले integration के लिए, context और configuration fields को छोड़ दें। /v2 के माध्यम से बना context यहाँ अपने-आप reuse के लिए eligible नहीं होता।

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/ppts" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Create a 5-slide introduction to retrieval augmented generation for software developers."}'

HTTP 200 root पर identifiers लौटाता है:

{
  "task_id":"example-task-id",
  "ppt_business_id":"example-ppt-id",
  "livedoc_short_id":"example-livedoc-id",
  "expires_at":"2026-11-13T00:00:00Z"
}

अतिरिक्त identifiers जैसे resource_id, stream_key और thread_short_id भी मौजूद हो सकते हैं। Successful create response का अर्थ है कि task स्वीकार कर ली गई, यह नहीं कि generation पूरी हो गई। Requested slide count केवल instruction है; billing actual generated page count का उपयोग करती है।

TASK_ID="example-task-id"
PPT_ID="example-ppt-id"

SSE के साथ जनरेशन घटनाएँ पढ़ें

यदि creation एक stream_key लौटाती है, तो उसी account की API Key के साथ तुरंत connect करें। यदि कोई stream key न लौटे, तो नीचे दिए गए status और result queries का उपयोग करें।

curl -N 'https://openapi.felo.ai/api/v1/data/conversations/stream/YOUR_STREAM_KEY?format=structured' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: text/event-stream'

हर complete SSE event पढ़ें, उसकी outer JSON decode करें, फिर content process करें। एक answer application event data.text में text रखता है; finished stream में generation completion का संकेत देता है। Upstream done, [DONE], और error signals को भी handle करें। यदि completion signal के बिना connection बंद हो जाए, तो task status query करें।

SuperAgent SSE में parsing rules और client example का उपयोग करें, इस section के /api/v1/data/conversations/stream/{stream_key} URL के साथ। Stream समाप्त होने के बाद task result पढ़ें; PPTX export अलग step ही रहती है। यह endpoint /api/v1/data/chat पर stream: true सक्षम नहीं करता।

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

3. जनरेशन परिणाम पढ़ें

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

यह एक POST है, जिसमें किसी JSON body की आवश्यकता नहीं है।

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

{
  "task_id":"example-task-id",
  "task_status":"COMPLETED",
  "history_data":{},
  "error_message":null
}

history_data का उपयोग करने से पहले task_status पढ़ें। History payload task के अनुसार बदल सकती है और null भी हो सकती है। ai_page_html और thread_short_id optional हैं। यह response guaranteed PPTX download URL नहीं है; अगला step export है।

4. PPTX निर्यात प्रारंभ करें

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

curl -sS --request POST "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"

{"status":"PROCESSING","download_url":null,"expires_at":null}

Export करने से पहले generation पूरी होनी चाहिए। वही export चल रही होने पर POST दोहराने से उसी का reuse होता है। Completion के बाद दूसरी export शुरू करने से नई export बनती है और फिर से charge लग सकता है। Polling और download link refresh करने के लिए GET का उपयोग करें।

5. निर्यात पोल करें और डाउनलोड करें

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"

{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

Example URL केवल illustrative है। Response से actual signed URL का उपयोग करें। यह 30 minutes के लिए valid है; जब तक प्रस्तुति उपलब्ध है, GET export status एक fresh link लौटा सकता है। File को उसकी lifetime के भीतर save करें। अपनी Felo API key को file download host पर न भेजें।

6. प्रस्तुति हटाएँ

DELETE /api/v1/data/ppts/{business_id}

curl -sS --request DELETE "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID" \
  -H "Authorization: Bearer $FELO_API_KEY"

Success पर HTTP 204 बिना body के लौटता है। इसे JSON की तरह parse न करें। Generation चलते समय deletion पर 409 लौटता है।

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

• प्रस्तुतियाँ 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 देखें।