API ত্রুটি

এই পৃষ্ঠায় সমস্ত ইন্টারঅ্যাকশনস এপিআই (Interactions API) এরর কোডের একটি রেফারেন্স দেওয়া হয়েছে, এরর রেসপন্স ফরম্যাট বর্ণনা করা হয়েছে এবং বিভিন্ন ধরনের রিকোয়েস্টের জন্য এপিআই কীভাবে এরর প্রদান করে তা ব্যাখ্যা করা হয়েছে।

Standard API error codes

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

কোড HTTP Status বর্ণনা Recommended action
invalid_request 400 Bad Request অনুরোধের পেলোডটি ত্রুটিপূর্ণ অথবা এতে অবৈধ প্যারামিটার রয়েছে। আপনার অনুরোধের সিনট্যাক্স এবং প্যারামিটারগুলো এপিআই রেফারেন্সের সাথে মিলিয়ে নিন।
failed_precondition 400 Bad Request অনুরোধটি প্রক্রিয়া করা যাচ্ছে না কারণ একটি পূর্বশর্ত পূরণ হয়নি (উদাহরণস্বরূপ, বিলিং নিষ্ক্রিয় থাকা)। প্রকল্পের বিলিং স্ট্যাটাস বা অ্যাকাউন্টের পূর্বশর্তগুলো যাচাই করুন।
out_of_range ৪১৬ অনুরোধকৃত পরিসর সন্তোষজনক নয় Request parameter is outside the valid range. প্যারামিটারের মান ও সীমা যাচাই করুন।
parameter_unknown 400 Bad Request The request contains an unknown parameter. Remove the unrecognized parameter and retry.
authentication 401 Unauthorized The API key is missing, invalid, or expired. Verify your API key .
payment_required 402 Payment Required Your Prepay credit balance is depleted. আপনার বিলিং অ্যাকাউন্টে ক্রেডিট যোগ করুন , অথবা অটো-রিলোড চালু করুন। পুনরায় চেষ্টা করবেন না: ক্রেডিট যোগ না করা পর্যন্ত অনুরোধটি সফল হবে না।
permission_denied ৪০৩ নিষিদ্ধ আপনার এপিআই কী-এর এই রিসোর্সটির জন্য অনুমতি নেই। আপনার এপিআই কী-এর অনুমতি এবং প্রজেক্ট অ্যাক্সেস যাচাই করুন।
not_found ৪০৪ পাওয়া যায়নি The requested resource was not found. Verify the resource path and parameters.
model_not_found ৪০৪ পাওয়া যায়নি The specified model was not found. মডেলের নাম যাচাই করুন অথবা অন্য কোনো মডেল ব্যবহার করুন।
already_exists 409 Conflict আপনি যে সত্তাটি তৈরি করার চেষ্টা করেছিলেন তা ইতিমধ্যেই বিদ্যমান। পুনরায় তৈরি করার আগে রিসোর্সটি আগে থেকেই বিদ্যমান আছে কিনা তা যাচাই করুন।
aborted ৪০৯ সংঘাত দ্বন্দ্ব অথবা যুগপৎ কার্যকারিতা যাচাইয়ে ব্যর্থতার কারণে অপারেশনটি বাতিল করা হয়েছে। Retry the request at a higher application level.
rate_limit_exceeded ৪২৯টি অতিরিক্ত অনুরোধ আপনি প্রতি মিনিট বা প্রতি সেকেন্ডের অনুরোধ বা টোকেন সীমা অতিক্রম করেছেন। Wait and retry with exponential backoff.
quota_exceeded ৪২৯টি অতিরিক্ত অনুরোধ You have exceeded your daily quota. কোটা পুনরায় সেট হওয়া পর্যন্ত অপেক্ষা করুন অথবা কোটা বৃদ্ধির জন্য অনুরোধ করুন।
too_many_requests ৪২৯টি অতিরিক্ত অনুরোধ আপনি অল্প সময়ের মধ্যে অনেক বেশি অনুরোধ করেছেন। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাকঅফ সহ পুনরায় চেষ্টা করুন।
cancelled 499 Client Closed Request ক্লায়েন্ট অনুরোধটি সম্পূর্ণ হওয়ার আগেই বাতিল করে দিয়েছে। কোনো পদক্ষেপের প্রয়োজন নেই। এর মানে সাধারণত ক্লায়েন্ট সংযোগ বিচ্ছিন্ন করেছে।
api_error 500 Internal Server Error An unexpected error occurred on the server. অনুরোধটি পুনরায় চেষ্টা করুন। সমস্যাটি অব্যাহত থাকলে, সাপোর্টের সাথে যোগাযোগ করুন।
unimplemented 501 Not Implemented অপারেশন বা ফিচারটি বাস্তবায়িত বা সমর্থিত নয়। API-এর সক্ষমতা যাচাই করুন অথবা সমর্থিত কোনো ফিচারে স্যুইচ করুন।
service_unavailable ৫০৩ পরিষেবা অনুপলব্ধ পরিষেবাটি সাময়িকভাবে অতিরিক্ত ভারাক্রান্ত বা বন্ধ রয়েছে। অপেক্ষা করুন এবং এক্সপোনেনশিয়াল ব্যাকঅফ সহ পুনরায় চেষ্টা করুন।
deadline_exceeded 504 Gateway Timeout The request didn't finish within the deadline. সার্ভারের ডিফল্ট ব্যবহার করার জন্য ক্লায়েন্টের ডেডলাইন সেটিংটি সরিয়ে ফেলুন বা বাড়িয়ে দিন।

প্রজন্ম অবরুদ্ধ কোড

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

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

Generation error codes

এই ত্রুটি কোডগুলি মডেলের তৈরি আউটপুটের কাঠামোগত সমস্যা নির্দেশ করে (যেমন একটি ত্রুটিপূর্ণ ফাংশন কল বা একটি অঘোষিত টুল কল)।

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

ত্রুটি প্রতিক্রিয়া বিন্যাস

ইন্টারঅ্যাকশনস এপিআই থেকে আসা সমস্ত ত্রুটি একটি 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 অনুরোধ

সাধারণ (নন-স্ট্রিমিং) অনুরোধের ক্ষেত্রে, এপিআই 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 সার্ভার-সেন্ট ইভেন্টস (SSE) স্ট্রিমের মাধ্যমে "error" event_type সহ এরর ইভেন্ট পাঠায়। error ফিল্ডটিতে একই code এবং message কাঠামো থাকে:

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

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

এরপর কী?