API সংক্রান্ত সমস্যা

এই পৃষ্ঠা থেকে আপনি Interactions API-এর সব ত্রুটি কোডের রেফারেন্স পাবেন, ত্রুটি সংক্রান্ত উত্তরের ফর্ম্যাট সম্পর্কে জানতে পারবেন এবং বিভিন্ন ধরনের অনুরোধের ক্ষেত্রে API কীভাবে ত্রুটি দেখায় তা বুঝতে পারবেন।

স্ট্যান্ডার্ড API ত্রুটি কোড

এই সাধারণ অনুরোধ-লেভেল ত্রুটি কোডগুলি স্ট্যান্ডার্ড HTTP স্ট্যাটাস কোডের সাথে সম্পর্কিত। প্রোগ্রাম্যাটিক্যালি সমস্যা সমাধান করতে আপনার অ্যাপ্লিকেশন লজিকে code ফিল্ড ব্যবহার করুন।

কোড HTTP স্ট্যাটাস বিবরণ প্রস্তাবিত অ্যাকশন
invalid_request 400 ত্রুটিযুক্ত অনুরোধ অনুরোধের পেলোডটি ভুল ফর্ম্যাটে আছে অথবা এতে ভুল প্যারামিটার আছে। API রেফারেন্স-এর সাথে আপনার অনুরোধের সিনট্যাক্স ও প্যারামিটার মিলিয়ে দেখুন।
failed_precondition 400 ত্রুটিযুক্ত অনুরোধ অনুরোধটি প্রসেস করা যাবে না কারণ একটি পূর্বশর্ত পূরণ করা হয়নি (যেমন, বিলিং বন্ধ করা)। প্রোজেক্টের বিলিং স্ট্যাটাস বা অ্যাকাউন্টের পূর্বশর্ত যাচাই করুন।
out_of_range 416 অনুরোধ করা রেঞ্জ সন্তোষজনক নয় অনুরোধের প্যারামিটার সঠিক রেঞ্জের বাইরে। প্যারামিটারের ভ্যালু ও সীমা চেক করুন।
parameter_unknown 400 ত্রুটিযুক্ত অনুরোধ অনুরোধে অজানা প্যারামিটার আছে। অজানা প্যারামিটার সরিয়ে দিয়ে আবার চেষ্টা করুন।
authentication 401 অনুমোদিত নয় API কী নেই, ভুল বা মেয়াদ শেষ হয়ে গেছে। আপনার API key যাচাই করুন।
payment_required 402 পেমেন্ট করতে হবে আপনার প্রিপে ক্রেডিট ব্যালেন্স শেষ হয়ে গেছে। আপনার বিলিং অ্যাকাউন্টে ক্রেডিট যোগ করুন অথবা অটোমেটিক রিলোড ফিচার চালু করুন। আবার চেষ্টা করবেন না: ক্রেডিট যোগ না করা পর্যন্ত অনুরোধটি সফল হবে না।
permission_denied 403 নিষিদ্ধ এই রিসোর্সের জন্য আপনার API কী-এর অনুমতি নেই অথবা আপনার প্রোজেক্টের API অ্যাক্সেস সীমিত করা হয়েছে। আপনার API কী-এর অনুমতি, প্রোজেক্ট টিয়ারের উপযুক্ততা এবং বিলিং স্ট্যাটাস চেক করুন। প্রোজেক্ট সীমাবদ্ধ বা অনুপলভ্য হওয়া সংক্রান্ত সমস্যার সমাধান দেখুন।
not_found 404 পাওয়া যায়নি অনুরোধ করা রিসোর্স খুঁজে পাওয়া যায়নি। রিসোর্স পাথ ও প্যারামিটার যাচাই করুন।
model_not_found 404 পাওয়া যায়নি নির্দিষ্ট করা মডেল খুঁজে পাওয়া যায়নি। মডেলের নাম যাচাই করুন বা অন্য কোনও মডেল ব্যবহার করুন।
already_exists 409 কনফ্লিক্ট আপনি যে এন্টিটি তৈরি করার চেষ্টা করেছেন সেটি আগে থেকেই আছে। রিসোর্সটি আবার তৈরি করার আগে সেটি আগে থেকেই আছে কিনা তা চেক করুন।
aborted 409 কনফ্লিক্ট কোনও দ্বন্দ্ব বা কনকারেন্সি চেক সংক্রান্ত সমস্যার কারণে অপারেশনটি বাতিল করা হয়েছে। আরও উন্নত অ্যাপ্লিকেশন লেভেলে অনুরোধটি আবার করুন।
rate_limit_exceeded 429 অনেক বেশি অনুরোধ আপনি প্রতি মিনিট বা প্রতি সেকেন্ডে অনুরোধ বা টোকেনের সীমা অতিক্রম করেছেন। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাক-অফ সহ আবার চেষ্টা করুন।
quota_exceeded 429 অনেক বেশি অনুরোধ আপনি দৈনিক কোটা পেরিয়ে গেছেন। কোটা রিসেট হওয়া পর্যন্ত অপেক্ষা করুন অথবা কোটা বাড়ানোর অনুরোধ করুন।
too_many_requests 429 অনেক বেশি অনুরোধ আপনি খুব কম সময়ে অনেক বেশি বার অনুরোধ করেছেন। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাক-অফ সহ আবার চেষ্টা করুন।
cancelled 499 ক্লায়েন্ট অনুরোধ বন্ধ করেছে অনুরোধটি সম্পূর্ণ হওয়ার আগেই ক্লায়েন্ট সেটি বাতিল করে দিয়েছেন। কিছু করার প্রয়োজন নেই। এর অর্থ হল, ক্লায়েন্ট ডিসকানেক্ট হয়ে গেছে।
api_error 500 সার্ভারে ইন্টার্নাল সমস্যা সার্ভারে কোনও অপ্রত্যাশিত সমস্যা হয়েছে। অনুরোধটি আবার করুন। সমস্যাটি থেকে গেলে, সহায়তা টিমের সাথে যোগাযোগ করুন।
unimplemented 501 প্রয়োগ করা হয়নি অপারেশন বা ফিচারটি প্রয়োগ করা হয়নি বা কাজ করে না। API-এর ক্ষমতা চেক করুন বা কাজ করে এমন ফিচারে পাল্টে নিন।
service_unavailable 503 পরিষেবা উপলভ্য নেই পরিষেবা সাময়িকভাবে ওভারলোড হয়ে গেছে বা কাজ করছে না। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাক-অফ সহ আবার চেষ্টা করুন।
deadline_exceeded 504 গেটওয়ে টাইমআউট নির্দিষ্ট সময়সীমার মধ্যে অনুরোধটি সম্পূর্ণ করা যায়নি। সার্ভারের ডিফল্ট ব্যবহার করতে ক্লায়েন্টের ডেডলাইন সেটিং সরিয়ে দিন বা বাড়ান।

জেনারেট করা ব্লক কোড

এইসব ত্রুটি কোড থেকে বোঝা যায় যে নীতি, নিরাপত্তা বা কন্টেন্ট সংক্রান্ত বিধিনিষেধ মডেলের আউটপুট ব্লক করেছে। আপনি এই কোডগুলির মধ্যে কোনও একটি পেলে, আপনার ইনপুট পরিবর্তন করে আবার চেষ্টা করুন।

কোড বিবরণ
safety নিরাপত্তা সংক্রান্ত নীতি লঙ্ঘন (ক্ষতিকর কন্টেন্ট) করার কারণে অনুরোধ ব্লক করা হয়েছে।
recitation কপিরাইট বা আবৃত্তি সংক্রান্ত বিধিনিষেধের কারণে অনুরোধ ব্লক করা হয়েছে।
language অনুরোধটি এমন একটি ভাষায় করা হয়েছে যা কাজ করে না।
prohibited_content নিষিদ্ধ কন্টেন্ট সংক্রান্ত নির্দেশিকা অনুরোধটি ব্লক করেছে।
spii ব্যক্তিগতভাবে শনাক্তকরণযোগ্য অতি গোপনীয় তথ্য সংক্রান্ত বিধিনিষেধের কারণে অনুরোধটি ব্লক করা হয়েছে।
blocklist ব্লকলিস্টে থাকা নিষিদ্ধ শব্দ অনুরোধ ব্লক করেছে।
image_safety নিরাপত্তা সংক্রান্ত নীতি লঙ্ঘন করার কারণে ছবি জেনারেশন ব্লক করা হয়েছে।
image_prohibited_content নিষিদ্ধ কন্টেন্ট সংক্রান্ত নির্দেশিকা ইমেজ জেনারেশন ব্লক করেছে।
image_recitation কপিরাইট বা আবৃত্তি সংক্রান্ত বিধিনিষেধের কারণে ইমেজ জেনারেশন ব্লক করা হয়েছে।
image_other অনির্দিষ্ট কারণে ছবি জেনারেশন ব্লক করা হয়েছে।
content_blocked নীতি সংক্রান্ত কোনও অনির্দিষ্ট কারণে অনুরোধটি ব্লক করা হয়েছে।

জেনারেশন সংক্রান্ত সমস্যার কোড

এইসব ত্রুটি কোড মডেলের জেনারেট করা আউটপুটের স্ট্রাকচারাল সমস্যা (যেমন, ভুলভাবে ফর্ম করা ফাংশন কল বা ঘোষণা না করা টুল কল) নির্দেশ করে।

কোড বিবরণ
malformed_function_call মডেলটি এমন একটি ফাংশন কল তৈরি করেছে যা পার্স করা যায়নি।
malformed_tool_call মডেলটি একটি টুল কল তৈরি করেছে যা পার্স করা যায়নি।
unexpected_tool_call মডেলটি এমন একটি টুল কল করেছে যা অনুরোধে ঘোষণা করা হয়নি।
no_image মডেলটি ছবি জেনারেট করতে পারেনি।
too_many_tool_calls মডেলটি অনুমোদিত সংখ্যার চেয়ে বেশি টুল কল জেনারেট করেছে।
missing_thought_signature উত্তরে প্রয়োজনীয় থট সিগনেচার নেই।

সমস্যার উত্তর দেওয়ার ফর্ম্যাট

Interactions API থেকে আসা সব সমস্যা error অবজেক্ট রিটার্ন করে যার মধ্যে code ও message থাকে। যেমন, কাজ করে না এমন টুল টাইপ পাস করলে এটি রিটার্ন করে:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'. Supported values: 'function', 'code_execution', 'mcp_server', 'filesystem', 'google_maps', 'google_search', 'bash', 'computer_use', 'file_search', 'url_context'."
  }
}
ফিল্ড ধরন বিবরণ
code স্ট্রিং snake_case-এ মেশিনের ক্ষেত্রে গ্রহণযোগ্য ত্রুটি কোড।
message স্ট্রিং কী সমস্যা হয়েছে তার মানুষের-পঠনযোগ্য বিবরণ।

কীভাবে সমস্যার কথা জানানো হয়

আপনি স্ট্যান্ডার্ড HTTP অনুরোধ নাকি স্ট্রিমিং (SSE) অনুরোধ করছেন তার উপর নির্ভর করে API আলাদাভাবে সমস্যা দেখায়।

স্ট্যান্ডার্ড HTTP অনুরোধ

স্ট্যান্ডার্ড (নন-স্ট্রিমিং) অনুরোধের জন্য, API HTTP রেসপন্স স্ট্যাটাস কোড (যেমন 400 Bad Request, 401 Unauthorized বা 429 Too Many Requests) সেট করে এবং JSON রেসপন্স বডিতে একটি error অবজেক্ট রিটার্ন করে:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'."
  }
}

স্ট্রিমিং (SSE) অনুরোধ

স্ট্রিমিং অনুরোধের (stream: true) জন্য, API event_type-কে "error"-এ সেট করে Server-Sent Events (SSE) স্ট্রিমের মাধ্যমে সমস্যার ইভেন্ট পাঠায়। error ফিল্ডে একই code এবং message স্ট্রাকচার আছে:

{
  "event_type": "error",
  "error": {
    "code": "not_found",
    "message": "Failed to get completed interaction: Result not found."
  }
}

সম্পূর্ণ SSE ইভেন্ট স্কিমার জন্য, Interactions API রেফারেন্স দেখুন।

এর পরে কী করতে হবে