OpenAPI বিলিং এবং ত্রুটি

এই পৃষ্ঠা /api/v1/data/*-এর জন্য প্রযোজ্য, অর্থাৎ Felo OpenAPI platform-exclusive API-গুলো। Call-গুলো platform balance ব্যবহার করে, যা USD-এ নির্ধারিত service-credit balance। এগুলো Felo Pro credits ব্যবহার করে না। /v2-এর পুরোনো Felo APIs Pro credits ব্যবহার করে।

বর্তমান মূল্য পড়ুন

curl -sS https://openapi.felo.ai/api/v1/data/prices

এই public endpoint-এর জন্য কোনো key দরকার নেই। Operation ID দিয়ে এর entry-গুলো match করুন এবং বর্তমান rate ও billing unit পড়ুন; সব operation-এর খরচ একই—এমন ধরে নেবেন না বা example থেকে rate নিয়ে আপনার application-এ স্থির করে রাখবেন না।

একটি free status query মানে অন্তর্নিহিত generation বা export বিনামূল্যে—এমন নয়। X-এর ক্ষেত্রে, pagination এবং nested ফেরত আসা record billable usage বাড়াতে পারে।

ব্যালেন্স এবং সংরক্ষণ

Execution-এর আগে, service operation-এর জন্য যথেষ্ট balance reserve করতে পারে। Successful work সেই reservation-এর বিরুদ্ধে settle হয়; নিশ্চিত failure হলে তা release হয়। Async task-এর ক্ষেত্রে, ID ফেরত আসা মানেই billing ইতিমধ্যে final—এমন নয়।

PPT page pricing creation-এর সময় দশ পেজ reserve করে। Successful generation প্রকৃত output অনুযায়ী settle করে এবং unused fund release করে। Generation এবং export আলাদা charge। Repeat-export behavior-এর জন্য PPT workflow দেখুন।

Execution বা settlement অনিশ্চিত হলে, service reconcile করার সময় একটি reservation pending থাকতে পারে। প্রতিটি timeout বা 5xx-কে এমন প্রমাণ হিসেবে ধরবেন না যে কোনো কাজ হয়নি বা repeated request বিনামূল্যে।

Console Billing-এ আপনার available balance এবং usage পর্যালোচনা করুন। Account-level top-up guidance-এর জন্য Billing and Credits দেখুন।

API-এর মাধ্যমে ওয়ালেট ব্যবহার অনুধাবন করুন

Account owner-রা Felo login token ব্যবহার করে wallet call record পরীক্ষা করতে পারেন। এই credential Data API call-এর জন্য ব্যবহৃত API Key থেকে আলাদা; FELO_API_KEY প্রতিস্থাপন হিসেবে ব্যবহার করবেন না।

curl -sS 'https://openapi.felo.ai/api/wallet/usage?call_type=data' \
  -H 'Authorization: Bearer YOUR_FELO_LOGIN_TOKEN'

Record-গুলো data.items-এর অধীনে থাকে; call_type=data capability call filter করে। Account-এর বর্তমান মূল্যের সাথে usage তুলনা করুন। Record পড়া আরেকটি generation task submit করে না। Account review এবং top-up-এর জন্য Console Billing এখনও উপলভ্য।

ত্রুটিগুলি সুরক্ষিতভাবে পড়ুন

প্রথমে HTTP status পরীক্ষা করুন। Error এই দুইটির যেকোনো shape ব্যবহার করতে পারে; নিচের value-গুলো illustrative:

{"error":{"code":"invalid_parameter","message":"Check the request fields"},"request_id":"example-request-id"}

{"status":402,"code":"INSUFFICIENT_BALANCE","message":"Insufficient balance","request_id":"example-request-id"}

যেখানে উপস্থিত, error.code / error.message পড়ুন, অন্যথায় code / message পড়ুন। ফেরত এলে request_id সংরক্ষণ করুন। Successful response operation অনুযায়ী ভিন্ন হয়; সবকিছুকে একই error বা data envelope-এ বাধ্য করবেন না।

পরবর্তী কী করবেন তা নির্ধারণ করুন

execution_unconfirmed (409) এবং billing_settlement_pending (503)-এর ক্ষেত্রে বিশেষ সতর্কতা দরকার: সঙ্গে সঙ্গে paid work পুনরায় submit করবেন না। পরিচিত task query করুন বা request ID সহ support-এ যোগাযোগ করুন। Empty result-সহ successful HTTP status error response-এর থেকে ভিন্ন।

নতুন নকল কাজ তৈরি না করে আবার চেষ্টা করুন

• Read-only task এবং export-status query-র জন্য bounded backoff ব্যবহার করুন এবং উপস্থিত থাকলে Retry-After মানুন।
• Saved task_id-সহ failed create request-এর ক্ষেত্রে, আরেকটি তৈরি করার আগে সেই task query করুন।
• ID পাওয়ার আগেই connection ব্যর্থ হলে outcome অজানা থাকতে পারে। Resending request deduplicate করবে—এমন ধরে নেবেন না।
• 429-এর জন্য, একটি short rate limit এবং একটি API key quota window আলাদা করুন; বারবার retry করলে quota reset হবে না।
• Configured deadline-এর পরে retry বন্ধ করুন এবং caller-কে একটি actionable error দেখান।

Support-এর জন্য endpoint, আনুমানিক সময়, HTTP status এবং request ID দিন। কখনও সম্পূর্ণ API key অন্তর্ভুক্ত করবেন না।