Felo প্রেজেন্টেশন তৈরি

Asynchronously একটি presentation generate করুন, তারপর একটি PPTX file export করুন। Generation এবং export ধাপ আলাদা রাখুন: তৈরি করা task এখনও finished file নয়।

সব example-ই overview থেকে FELO_API_KEY ব্যবহার করে। Call-গুলো platform balance ব্যবহার করে, Felo Pro credits নয়। Response example-গুলো illustrative; live content এবং optional field ভিন্ন হতে পারে।

1. উপস্থাপনাটি তৈরি করুন

POST /api/v1/data/ppts

প্রথম integration-এর জন্য context এবং configuration field বাদ দিন। /v2 দিয়ে তৈরি context এখানে স্বয়ংক্রিয়ভাবে পুনর্ব্যবহারের জন্য 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-এ identifier ফেরত দেয়:

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

resource_id, stream_key এবং thread_short_id-এর মতো অতিরিক্ত identifier থাকতে পারে। Successful create response মানে task গৃহীত হয়েছে, generation সম্পূর্ণ হয়েছে—এমন নয়। Requested slide count একটি instruction; billing প্রকৃত 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 query ব্যবহার করুন।

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'

প্রতিটি সম্পূর্ণ SSE event পড়ুন, এর outer JSON decode করুন, তারপর content process করুন। একটি answer application event data.text-এ text বহন করে; finished stream-এ generation completion নির্দেশ করে। এছাড়াও upstream done, [DONE], এবং error signal 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 আলাদা ধাপই থাকে। এই endpoint /api/v1/data/chat-এ stream: true সক্রিয় করে না।

জীবনকাল, মালিকানা এবং বিলিং

• Presentation-গুলো creation-এর সাত দিন পরে মেয়াদোত্তীর্ণ হয়। Query এবং export এই সময়সীমা বাড়ায় না। Presentation expires_at এবং signed download URL expires_at ভিন্ন lifetime বর্ণনা করে।
• কেবল creating API account-ই তার task এবং presentation access করতে পারে। Missing বা inaccessible resource 404 ফেরত দিতে পারে; expired বা deleted resource 410, অথবা cleanup-এর পরে 404 ফেরত দিতে পারে।
• Generation প্রতি generated page (ppt.generate) অনুযায়ী বিল হয়। Page pricing-এ creation দশ পেজের মূল্য রিজার্ভ করে, তারপর প্রকৃত successful output অনুযায়ী চূড়ান্ত হিসাব করে এবং অব্যবহৃত reservation ছেড়ে দেয়। Prompt কম page চাইলে-ও reservation-এর জন্য আপনার account-এ যথেষ্ট available balance থাকতে হবে।
• Export-এর আলাদা request price (ppt.export) আছে। Status query, result query, export-status query এবং deletion নতুন charge তৈরি করে না।
• Timeout-এর পরে আরেকটি presentation তৈরি না করে saved task query করুন। Billing and Errors দেখুন।