সমস্যা সমাধান

লক্ষণ দিয়ে শুরু করুন, তারপর সমাধান অনুসরণ করুন। বেশিরভাগ ব্যর্থতা আসে base URL, key, মডেল ID বা ব্যালেন্স থেকে।

লক্ষণভিত্তিক টেবিল

প্রমাণীকরণ

প্রত্যাহৃত key এমন একটি message ফেরত দেয় যেখানে key-এর প্রিফিক্স উল্লেখ থাকে:

{
  "status": 401,
  "code": "UNAUTHORIZED",
  "message": "API Key has been revoked (keyPrefix=...)"
}

চেকলিস্ট:

• Model API এবং Felo API-র জন্য header হলো Authorization: Bearer <key>।
• Data API এছাড়া X-API-Key: <key> গ্রহণ করে।
• key কোটেশনে মোড়ানো নয়, এবং কপি করা পরিবেশ চলক থেকে কোনো শেষের newline নেই।
• ডিপ্লয় করা পরিবেশে আসলে ভেরিয়েবলটি সেট আছে; লোকালে কাজ করা key প্রোডাকশনে অনুপস্থিত থাকতে পারে।
• key মুছে ফেলা বা রোটেট করা হয়নি। মুছে ফেলা বা রোটেট করা key আবার দেখানো যায় না; নতুন একটি তৈরি করুন।

key তৈরি ও সীমার জন্য Authentication দেখুন।

Base URL-এর ফাঁদ

দুটি সাধারণ ভুল:

1. SDK ইতিমধ্যে বাড়ায় এমন base URL-এ /chat/completions যোগ করা।
2. Anthropic base URL https://openapi.felo.ai/api/v1 সেট করা। SDK /v1/messages যোগ করে, তাই অনুরোধ হয় /api/v1/v1/messages।

মডেল ID সমস্যা

মডেল ID হলো ক্যাটালগের পাবলিক ID, আপস্ট্রিম প্রোভাইডারের অভ্যন্তরীণ নাম বা প্রদর্শিত নাম নয়।

• মডেল পেজে বা GET /api/v1/models-এ ID খুঁজুন।
• মডেলটি আপনি যে প্রোটোকল কল করছেন তা সমর্থন করে (supported_protocols) নিশ্চিত করুন।
• আপনি চ্যানেল পিন করলে সেই চ্যানেলটি প্রকাশিত ও সেই মডেলের জন্য রানযোগ্য তা নিশ্চিত করুন। অনুপলব্ধ চ্যানেল ফলব্যাক নয়।

Channels and Provider Routing দেখুন।

স্ট্রিমিং সমস্যা

• অনুরোধ body-তে stream: true সেট করুন, query প্যারামিটার হিসেবে নয়।
• রেসপন্স body স্ট্রিম হিসেবে পড়ুন। সম্পূর্ণ রেসপন্সের অপেক্ষা স্ট্রিমিংকে ব্যর্থ করে।
• কিছু প্রক্সি ও সার্ভারলেস প্ল্যাটফর্ম রেসপন্স বাফার করে। যে রুট অনুরোধ প্রক্সি করে সেখানে বাফারিং বন্ধ করুন।
• Chat Completions choices[0].delta স্ট্রিম করে, choices[0].message নয়। চূড়ান্ত কনটেন্ট অনেক chunk জুড়ে আসে।
• সংযোগ বিচ্ছিন্ন হলে স্ট্রিম পরিষ্কার টার্মিনাল ইভেন্ট ছাড়াই শেষ হতে পারে। সংযোগ বিচ্ছিন্ন হওয়াকে অসম্পূর্ণ রেসপন্স হিসেবে ধরুন।

অ্যাসিঙ্ক টাস্ক সমস্যা

• টাস্ক পরিবারের নিজস্ব স্ট্যাটাস endpoint পোল করুন। Felo ওয়ার্কফ্লো GET /v2/tasks/{task_id}/status ব্যবহার করে; মডেলের ভিডিও ও ইমেজ টাস্ক তাদের নিজস্ব জেনারেশন endpoint ব্যবহার করে।
• কেবল সফলতাই নয়, ব্যর্থতা ও মেয়াদোত্তীর্ণতাসহ প্রতিটি টার্মিনাল স্ট্যাটাসে থামুন।
• ভিডিও ও ইমেজ callback বর্তমানে উপেক্ষা করা হয়। webhook-এর অপেক্ষা করবেন না।
• ফলাফলের URL স্বল্পস্থায়ী হতে পারে। ডাউনলোডের মেয়াদ শেষ হলে স্ট্যাটাস endpoint থেকে নতুন URL চান।
• আবার সাবমিট করার আগে টাস্ক দেখুন। চলমান টাস্ক আবার সাবমিট করলে ডুপ্লিকেট তৈরি হয় এবং দুটোই বিল হয়।

Async Tasks দেখুন।

Data API সমস্যা

• Data API রেফারেন্স থেকে সঠিক method path রাখুন।
• অনুরোধ body সরবরাহকারী-নির্দিষ্ট। এক সরবরাহকারীর জন্য কাজ করা ফিল্ড অন্য সরবরাহকারীর জন্য কাজ করবে তা নিশ্চিত নয়।
• একটি প্রোভাইডার ত্রুটি প্রোভাইডার-নির্দিষ্ট message সহ 4xx রেসপন্সের ভেতরে আসতে পারে। request_id ও রেসপন্স body লগ করুন।

নিরাপত্তা স্মারক

• ব্রাউজার কোড, মোবাইল অ্যাপ বান্ডল বা পাবলিক রিপোজিটরিতে কখনো API key রাখবেন না। এটি সার্ভারে রাখুন এবং অনুরোধ প্রক্সি করুন।
• সম্পূর্ণ key লগ করবেন না। শনাক্ত করতে হলে একটি প্রিফিক্স লগ করুন।
• key ফাঁস হয়ে থাকতে পারে এমন হলে সাথে সাথে রোটেট করুন।

সহায়তার সাথে যোগাযোগ করার আগে

সংগ্রহ করুন:

1. Endpoint ও HTTP method।
2. HTTP স্ট্যাটাস, code ও request_id।
3. মডেল ID বা টাস্ক ID।
4. টাইমজোনসহ টাইমস্ট্যাম্প।
5. গোপন তথ্য সরানো একটি ন্যূনতম অনুরোধ body।

অ্যাকাউন্টের ইমেইলসহ এটি সহায়তায় পাঠান। সম্পূর্ণ API key অন্তর্ভুক্ত করবেন না।

সম্পর্কিত

• Errors, Limits, and Retries
• Protocols and SDKs
• Billing and Credits
• Authentication