AI এজেন্টদের জন্য: সেটআপের ধাপে ধাপে নির্দেশিকা — /docs/agents.md, ডকুমেন্টেশন ইনডেক্স — /llms.txt।

এরর ও লিমিট

গেটওয়ের অনুরোধের সীমা, টাইমআউট এবং ত্রুটি কোড। প্রতিটি রেসপন্সের জন্য বলা আছে এটি কখন ঘটে এবং কী করতে হবে: অনুরোধটি আবার পাঠান বা সংশোধন করুন।

সংখ্যাগুলো GET /v1/capabilities রেসপন্সের limits ফিল্ড থেকে: সেখানে সর্বদা হালনাগাদ মান থাকে।

মডেলভিত্তিক রেসপন্সের দৈর্ঘ্য#

max_tokens না থাকলে গেটওয়ে ডিফল্ট বসায়: নন-স্ট্রিমে — ছোট, যাতে রেসপন্স টাইমআউটের মধ্যে ফিট হয়, স্ট্রিমে — মডেলের সিলিং। max_completion_tokens — একই ফিল্ড।

ত্রুটির বডি হলো একটি error অবজেক্ট যাতে message, type, code, param ফিল্ড থাকে; সব ত্রুটিতে সব ফিল্ড থাকে না। স্ট্যাটাস এবং type দেখে বুঝুন, code দিয়ে নিশ্চিত করুন: message টেক্সট পরিবর্তন হতে পারে। Anthropic ফরম্যাট Anthropic ত্রুটি ফরম্যাট বিভাগে।

{
  "error": {
    "message": "Model is currently overloaded in the Gonka network",
    "type": "rate_limit_exceeded",
    "code": "upstream_rate_limited"
  }
}

স্ট্রিম খোলার আগে প্রত্যাখ্যান সাধারণ রেসপন্স কোড হিসেবে আসে — স্ট্রিম ছাড়া যেমন হয়। খোলার পর স্ট্যাটাস ইতিমধ্যে 200, এবং ত্রুটি এভাবে আসে:

• Chat Completions — error ফিল্ড সহ joingonka-error চাঙ্ক, তারপর [DONE] ছাড়া বিচ্ছেদ।
• প্রারম্ভিক উত্তরের পর স্ট্রিম ছাড়া — স্ট্যাটাস 200 এবং error ফিল্ড সহ বডি।
• Anthropic Messages — event: error ইভেন্ট, তারপর স্ট্রিম বন্ধ হয়।
• OpenAI Responses — response.failed ইভেন্ট, কারণ response.error.code এ।
• Legacy Completions — data: {"error": …}, তারপর [DONE]।

data: {"id":"joingonka-error","object":"chat.completion.chunk","model":"MiniMaxAI/MiniMax-M2.7","choices":[],"error":{"message":"Gonka network error","type":"api_error"}}

• POST /v1/messages Anthropic এনভেলপে উত্তর দেয়: {"type": "error", "error": {"type", "message"}}।
• গেটওয়ে প্রত্যাখ্যান উপরের টেবিল থেকে type সংরক্ষণ করে (insufficient_funds, model_unavailable এবং অন্যান্য); এই এনভেলপে code ফিল্ড নেই — কারণ টেক্সটে।
• অনুরোধ ফর্মের ত্রুটি — invalid_request_error: মেসেজ বা max_tokens নেই, নাম ছাড়া টুল কল, অজানা মডেল।
• অজানা পথ — not_found_error, খুব বড় বডি — request_too_large।

event: error
data: {"type":"error","error":{"type":"timeout","message":"Upstream timeout"}}

• Retry-After থেকে বিরতির পরে: 429
• ক্রমবর্ধমান বিরতি সহ — 1, 2, 4 সেকেন্ড এবং আরও: 500, 502, 503 service_unavailable, 504
• অন্য মডেলের সাথে: 503 model_unavailable
• পরিবর্তন ছাড়া পুনরায় চেষ্টা করবেন না — অনুরোধ, কী বা ব্যালেন্স সংশোধন করুন: 400, 401, 402, 403, 404, 413, 415, 501

504 এর পরে প্রতিটি পুনরায় চেষ্টা — ইনপুট অনুমানের নতুন কাটতি; দীর্ঘ উত্তরের জন্য stream: true চালু করুন।

ত্রুটি বারবার হলে সাপোর্টে লিখুন এবং রেসপন্স হেডার থেকে x-request-id সংযুক্ত করুন।