ত্রুটি, সীমা ও পুনরায় চেষ্টা

প্রতিটি Felo API একটি স্থিতিশীল error code ও একটি request ID সহ JSON error body ফেরত দেয়। প্রথমে HTTP স্ট্যাটাস, তারপর code, তারপর message পড়ুন।

Error envelope

বর্তমান প্রোডাকশন রেসপন্স status হিসেবে HTTP স্ট্যাটাস ব্যবহার করে:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid API Key",
  "request_id": "202610221444486982113280416060637185"
}

কিছু পুরোনো endpoint উদাহরণ status: "error" ও ভিন্ন code স্ট্রিং ব্যবহার করে। message-এর সঠিক শব্দবিন্যাসের বদলে HTTP স্ট্যাটাস ও code-এর ভিত্তিতে শাখা তৈরি করুন।

সাধারণ কোড

Endpoint রেফারেন্স সেই endpoint-এর নির্দিষ্ট কোড তালিকাভুক্ত করে। Chat API ত্রুটি বা আপনি যে endpoint কল করছেন তার রেফারেন্স দিয়ে শুরু করুন।

মডেল জেনারেশন endpoint

POST /api/v1/images/generations ও POST /api/v1/videos/generations উপরের envelope-এর বদলে OpenAI envelope-এ endpoint-স্তরের ত্রুটি ফেরত দেয়:

{
  "error": {
    "message": "Model kind does not match this generation endpoint",
    "type": "invalid_request_error",
    "param": null,
    "code": "model_kind_mismatch"
  }
}

request ID body-তে নয়, X-Request-Id রেসপন্স header-এ থাকে। প্রত্যাখ্যাত অনুরোধ কোনো টাস্ক তৈরি করে না। টাস্ক তৈরি হয়ে গেলে বেশিরভাগ ব্যর্থতা HTTP ত্রুটির বদলে 200 রেসপন্সে টার্মিনাল টাস্ক স্ট্যাটাস হিসেবে আসে: failed বা interrupted-এর জন্য status দেখুন, তারপর error.message পড়ুন। Image Generation ও Async Tasks দেখুন।

Request ID

Felo error body-তে request_id থাকে। এটি endpoint, HTTP স্ট্যাটাস, error code, মডেল ID ও টাস্ক ID-সহ লগ করুন। সম্পূর্ণ API key কখনো লগ করবেন না।

Model API একটি ঐচ্ছিক X-Request-Id অনুরোধ header-ও গ্রহণ করে। আপনি একটি পাঠালে ডায়াগনস্টিকসের জন্য তা ফেরত পাঠানো হয়, যা আপনার নিজের লগকে একটি অনুরোধের সাথে সম্পর্কিত করতে দেয়। আপনি না পাঠালে ফেরত আসা request_id ব্যবহার করুন।

রেট সীমা

/v2/chat হলো নথিভুক্ত কার্যকর রেট সীমাযুক্ত একমাত্র Felo endpoint:

• প্রতি API key, 1 মিনিটের উইন্ডো।
• প্রতি ব্যবহারকারী, 1 মিনিটের উইন্ডো।
• প্রতি ব্যবহারকারী, 1 ঘণ্টার উইন্ডো।

কার্যকর পেইড Felo সাবস্ক্রিপশন, এন্টারপ্রাইজ সাবস্ক্রিপশনসহ, থাকা ব্যবহারকারীরা ব্যতিক্রম এবং কোনো X-RateLimit-* header পান না। সাবস্ক্রিপশন অবস্থা যাচাই করা না গেলে সীমা প্রযোজ্য থাকে।

অন্যান্য /v2/** endpoint-এ বর্তমানে কোনো কার্যকর রেট সীমা নেই। Model API অনুরোধ এখনো আপস্ট্রিম প্রোভাইডার দ্বারা সীমিত হতে পারে, যা 429 হিসেবে দেখা দিতে পারে।

সাংখ্যিক সীমা হার্ডকোড করবেন না। প্রতিটি রেসপন্সের header পড়ুন।

রিট্রাই নীতি

প্রস্তাবিত লুপ:

1. কেবল idempotent বা পুনরাবৃত্তি-নিরাপদ অনুরোধ রিট্রাই করুন।
2. এক্সপোনেনশিয়াল ব্যাকঅফ ব্যবহার করুন: প্রায় 1 সেকেন্ড দিয়ে শুরু করুন, দ্বিগুণ করুন, 30 সেকেন্ডে সীমাবদ্ধ রাখুন।
3. র‍্যান্ডম jitter যোগ করুন যাতে ক্লায়েন্টরা একসাথে রিট্রাই না করে।
4. অল্প সংখ্যক চেষ্টার পরে থামুন এবং ত্রুটি প্রকাশ করুন।
5. 429-এ নিজের সময়সূচির বদলে Retry-After মানুন।

ডিবাগিং ক্রম

1. key উপস্থিত ও প্রত্যাহারকৃত নয় তা দেখুন।
2. প্রমাণীকরণ নিশ্চিত করতে একই key দিয়ে GET /api/v1/models কল করুন।
3. লক্ষ্য endpoint-এ ক্ষুদ্রতম বৈধ অনুরোধ পাঠান।
4. একবারে একটি করে স্ট্রিমিং, tools বা বড় input যোগ করুন।
5. অ্যাসিঙ্ক কাজের জন্য আবার সাবমিট করার আগে টাস্ক স্ট্যাটাস দেখুন।

সম্পর্কিত

• প্রমাণীকরণ
• Channels and Provider Routing
• Async Tasks
• Troubleshooting