ম্যানেজমেন্ট কীজ — Gonka-এ SaaS

ম্যানেজমেন্ট কীগুলি হল গঙ্কা এআই গেটওয়ের উপরে SaaS পণ্য তৈরির জন্য অনুক্রমিক API কীয়ের একটি সিস্টেম।

আর্কিটেকচারটি দ্বি-স্তরের:

• ম্যানেজমেন্ট কী (gm-) — আপনার মাস্টার-কী। এটি সরাসরি ইনফারেন্সের জন্য ব্যবহৃত হয় না — শুধুমাত্র চাইল্ড কী তৈরি এবং পরিচালনার জন্য।
• চাইল্ড কী (gc-) — আপনার ক্লায়েন্টের জন্য কী। ইনফারেন্স-অনুরোধের জন্য ব্যবহৃত হয়। বিলিং ম্যানেজমেন্ট কী-এর মালিকের ব্যালেন্স থেকে কাটা হয়।

এটি একটি হোয়াইট-লেবেল মডেল: আপনার ক্লায়েন্টরা তাদের gc- কীগুলির মাধ্যমে কাজ করে এবং Gonka সম্পর্কে জানে না — তাদের কাছে এটি আপনার পরিষেবা।

ম্যানেজমেন্ট কীজ ছাড়া আপনি সমস্ত ক্লায়েন্টদের কাছে একটি API-কী বিতরণ করতেন - খরচ নিয়ন্ত্রণ, আইসোলেশন, বিশ্লেষণ ছাড়া। ম্যানেজমেন্ট কীজ 4টি সমস্যা সমাধান করে:

ধাপ ১: gate.joingonka.ai-এ রেজিস্ট্রেশন করুন এবং GNK, WGNK বা USDT দিয়ে ব্যালেন্স টপ-আপ করুন।

ধাপ ২: API-এর মাধ্যমে একটি management key তৈরি করুন:

curl -X POST https://gate.joingonka.ai/api/management/keys \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "My SaaS"}'

উত্তরে একটি plain key (প্রিফিক্স gm-) থাকে — এটি সংরক্ষণ করুন, এটি শুধুমাত্র একবারই দেখানো হয়।

ধাপ ৩: ক্লায়েন্টের জন্য একটি child key তৈরি করুন:

curl -X POST https://gate.joingonka.ai/api/management/keys/{gm_key_id}/children \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "Client A", "limit_daily_ngonka": "1000000000", "rate_limit_rpm": 30}'

Client A ১ GNK/দিন এবং ৩০টি অনুরোধ/মিনিট লিমিটসহ একটি gc- কি (key) পাবে।

প্রতিটি চাইল্ড কী তিনটি ধরণের সীমাবদ্ধতা সমর্থন করে:

• দৈনিক সীমা (limit_daily_ngonka) — UTC দিনের জন্য সর্বাধিক ব্যয়। UTC মধ্যরাতে স্বয়ংক্রিয়ভাবে রিসেট হয়।
• মাসিক সীমা (limit_monthly_ngonka) — ক্যালেন্ডার মাসের জন্য সর্বাধিক।
• TTL (expires_at) — কী মেয়াদোত্তীর্ণ হওয়ার তারিখ/সময়। এই সময় পর কী আর প্রমাণীকরণ হয় না।

দৈনিক বা মাসিক সীমা অতিক্রম করলে ক্লায়েন্ট বিস্তারিত সহ HTTP 402 পায়:

{"error": {"type": "child_key_limit", "daily_remaining": "0", "monthly_remaining": "500000000"}}

সমস্ত সীমা ঐচ্ছিক — যদি উল্লেখ না করা হয়, কী শুধুমাত্র মালিকের ব্যালেন্স দ্বারা সীমাবদ্ধ থাকে।

API এর মাধ্যমে সম্পূর্ণ CRUD:

ড্যাশবোর্ডের মাধ্যমেও পরিচালনা করা যায়: API কীজ → ম্যানেজমেন্ট কীজ বিভাগ।

JoinGonka সস্তা Gonka-inference-নেটওয়ার্কের উপরে management keys-এর জন্য GNK-লিমিট, TTL এবং Dashboard UI প্রদান করে।