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 बदलते रहते हैं।

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 सक्षम नहीं करता।

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

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