Rivya API-র প্রকাশ্য ত্রুটি সংকেত, HTTP অবস্থা, অনুরোধের হারসীমা, idempotency দ্বন্দ্ব ও আবার অনুরোধ পাঠানোর সিদ্ধান্ত সামলান।

Rivya API, JSON-এ স্থিতিশীল প্রকাশ্য ত্রুটি সংকেত ফেরত দেয়। সংযোগের চুক্তি হিসেবে error.code-এর মান ব্যবহার করুন।

ত্রুটির গঠন

{
  "error": {
    "code": "api_key_missing",
    "message": "A valid Bearer API key is required.",
    "requestId": "req_..."
  }
}

ব্যর্থ API অনুরোধ তদন্তে Rivya সহায়তা দলের সঙ্গে যোগাযোগের জন্য কার্যবিবরণীতে requestId রাখুন।

স্থিতিশীল ত্রুটি কোড

সংকেত	HTTP অবস্থা	অর্থ	প্রস্তাবিত কাজ
`public_api_disabled`	503	প্রকাশ্য API অনুরোধ সাময়িকভাবে বন্ধ।	পরে আবার চেষ্টা করুন অথবা Studio হাতে ব্যবহার করুন।
`api_key_missing`	401	অনুরোধে প্রয়োজনীয় API কী নেই।	`Authorization: Bearer rvya_sk_...` পাঠান।
`api_key_invalid`	401	কী যাচাই করা যাচ্ছে না।	কী যাচাই করুন এবং প্রয়োজনে পরিবর্তন করুন।
`api_key_revoked`	401	বিন্যাস থেকে কী প্রত্যাহার করা হয়েছে।	নতুন কী তৈরি করুন।
`api_key_expired`	401	কীটির মেয়াদ শেষ।	নতুন কী তৈরি করুন।
`api_scope_denied`	403	কীতে প্রয়োজনীয় অনুমতির পরিধি নেই।	প্রয়োজনীয় অনুমতিসহ কী তৈরি করুন।
`rate_limited`	429	বর্তমান সময়সীমায় অতিরিক্ত অনুরোধ এসেছে।	বিরতি বাড়িয়ে পরে চেষ্টা করুন।
`validation_failed`	400	অনুরোধ, model, prompt বা পরামিতি অবৈধ।	মডেল নির্দেশিকার সঙ্গে অনুরোধ তুলনা করুন।
`not_found`	404	চাওয়া কাজটি নেই অথবা অ্যাকাউন্টটির নয়।	প্রকাশ্য কাজের ID ও অ্যাকাউন্টের সীমা যাচাই করুন।
`webhook_url_rejected`	400	webhook সংযোগবিন্দুর URL অনুমোদিত নয়।	পরিচয়পত্র, খণ্ডচিহ্ন, স্থানীয় হোস্ট বা ব্যক্তিগত নেটওয়ার্কের ঠিকানা ছাড়া প্রকাশ্য HTTPS URL ব্যবহার করুন।
`chat_model_not_supported`	400	নির্বাচিত মডেলটি Chat API-তে ব্যবহারযোগ্য নয়।	`/api/v1/models` পড়ে ব্যবহারযোগ্য Chat মডেল বেছে নিন।
`chat_session_conflict`	409	এই অনুরোধে Chat সেশনটি ব্যবহার করা যাবে না।	একই অ্যাকাউন্ট ও মডেলের API-তে তৈরি সেশন ব্যবহার করুন।
`chat_attachment_not_supported`	400	Chat সংযুক্তি সমর্থিত নয়।	ফাইলস API দিয়ে ছবি আপলোড করে তার `file_id` পাঠান।
`idempotency_conflict`	409	একই idempotency কী ভিন্ন ইনপুটে আবার ব্যবহার করা হয়েছে।	নতুন কী ব্যবহার করুন অথবা হুবহু একই অনুরোধ আবার পাঠান।
`insufficient_credits`	402	অ্যাকাউন্টে যথেষ্ট ক্রেডিট নেই।	ক্রেডিট যোগ করুন অথবা কম খরচের অনুরোধ বেছে নিন।
`internal_error`	500	অনুরোধটি সম্পন্ন করা যায়নি।	idempotency-সহ আবার চেষ্টা করুন অথবা `requestId` দিয়ে সহায়তা নিন।

অনুরোধের হারসীমা

Rivya প্রতিটি API কীতে প্রয়োগস্তরের প্রকাশ্য API হারসীমা আরোপ করে। উৎপাদনের পূর্বনির্ধারিত সীমা PUBLIC_API_RATE_LIMIT_PER_MINUTE দিয়ে কনফিগার করা হয়।

rate_limited পেলে ক্রমবর্ধমান বিরতি ব্যবহার করুন। একটানা ঘন ঘন চেষ্টা করবেন না।

নিরাপদ পুনরায় চেষ্টা

উৎপাদনের প্রতিটি POST /api/v1/generations ও POST /api/v1/chat/completions অনুরোধে Idempotency-Key পাঠান।

প্রস্তাবিত পদ্ধতি:

প্রতিটি যৌক্তিক তৈরির অনুরোধের জন্য আলাদা কী তৈরি করুন
একই অনুরোধ আবার পাঠানোর সময়ই শুধু একই কী ব্যবহার করুন
ফেরত পাওয়া প্রকাশ্য কাজের ID নিজের কাজের নথিতে সংরক্ষণ করুন
Chat API-তে একই কথোপকথন চালাতে চাইলে ফেরত পাওয়া session_id সংরক্ষণ করুন
একটি কী ভিন্ন model, prompt বা পরামিতিতে আবার ব্যবহার করবেন না

অনুরোধ পাঠানোর পর নেটওয়ার্ক ব্যর্থ হলে একই অনুরোধ ও একই Idempotency-Key দিয়ে আবার চেষ্টা করুন। Rivya নকল কাজ তৈরি না করে সংরক্ষিত প্রকাশ্য উত্তর ফেরত দিতে পারে।

পুনরায় চেষ্টার সিদ্ধান্ত

নিচের ক্ষেত্রে বিরতি বাড়িয়ে আবার চেষ্টা করুন:

public_api_disabled
rate_limited
internal_error
সাময়িক নেটওয়ার্ক ব্যর্থতা

ইনপুট না বদলে নিচের ক্ষেত্রে আবার চেষ্টা করবেন না:

api_key_invalid
api_key_revoked
api_scope_denied
validation_failed
webhook_url_rejected
chat_model_not_supported
chat_session_conflict
chat_attachment_not_supported
idempotency_conflict
insufficient_credits

API ত্রুটি ও সীমা

ত্রুটির গঠন

স্থিতিশীল ত্রুটি কোড

অনুরোধের হারসীমা

নিরাপদ পুনরায় চেষ্টা

পুনরায় চেষ্টার সিদ্ধান্ত

সম্পর্কিত পৃষ্ঠা

সূচিপত্র