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

প্রাইসিং এবং অ্যাকাউন্ট

মডেলের দাম, ডিপোজিট ও উইথড্রয়াল ফি, GNK রেট। কী দিয়ে অ্যাকাউন্ট API: ব্যালেন্স, দিন ও মডেল অনুযায়ী খরচ, লেনদেনের ইতিহাস এবং টপ-আপ।

মডেলের দাম#

দামে ইতিমধ্যে 10% প্ল্যাটফর্ম মার্কআপ অন্তর্ভুক্ত। লাইভ মান — GET /api/pricing, কী ছাড়া।

modelইনপুট, $ প্রতি 1M টোকেনআউটপুট, $ প্রতি 1M টোকেনপ্রতি টোকেন nGNK: ইনপুট / আউটপুট
MiniMaxAI/MiniMax-M2.7$0.008349$0.0250533 / 99
deepseek-ai/DeepSeek-V4-Flash-0731$0.008349$0.0250533 / 99
zai-org/GLM-5.3-Flash$0.008349$0.0250533 / 99
  • অনুরোধের খরচ = ইনপুট টোকেন × ইনপুট মূল্য + আউটপুট × আউটপুট মূল্য। মডেলের রিজনিং আউটপুট টোকেন হিসেবে গণনা করা হয়।
  • কাটতি — GNK তে (1 GNK = 10⁹ nGNK); ডলারে দাম — GNK রেট $0.253 অনুযায়ী।
  • অনুরোধের আগে গেটওয়ে খরচের অনুমানের সাথে ব্যালেন্স মেলায়; যথেষ্ট না হলে — 402 insufficient_funds।
  • নিবন্ধনের পর অ্যাকাউন্টে 0.1 GNK আসে — ইনপুট মূল্যে প্রায় 3M টোকেন।

ফি#

অপারেশনফিনোট
মডেল অনুরোধে মার্কআপ10%ইতিমধ্যে উপরের দামে অন্তর্ভুক্ত।
GNK রিচার্জবিনামূল্যেআপনার memo সহ গেটওয়ে এড্রেসে ট্রান্সফার; স্বয়ংক্রিয়ভাবে জমা।
USDT রিচার্জ5% → 2.5%OxaPay এর মাধ্যমে পেমেন্ট; পরিমাণ যত বেশি, ফি তত কম — USDT ফি টায়ার।
Ethereum থেকে WGNK রিচার্জ1%Gonka তে ট্রান্সফারের সময় Ethereum নেটওয়ার্কের গ্যাস কভার করে।
GNK উইথড্র5%শুধুমাত্র কেবিনেট থেকে, 1 GNK থেকে।
GNK রেট$0.253এর মাধ্যমে রিচার্জ এবং ডলারে দাম গণনা করা হয়; স্বয়ংক্রিয়ভাবে আপডেট হয়।

USDT ফি টায়ার#

হার রিচার্জের পরিমাণের উপর নির্ভর করে, থ্রেশহোল্ড অন্তর্ভুক্ত:

রিচার্জের পরিমাণফি
$0 থেকে5%
$25 থেকে4.5%
$50 থেকে4%
$100 থেকে3.5%
$250 থেকে3%
$500 থেকে2.75%
$1000 থেকে2.5%

অ্যাকাউন্ট API#

ব্যালেন্স, খরচ এবং রিচার্জ মডেল অনুরোধের মতো একই কী দিয়ে উপলব্ধ (Authorization: Bearer jg-…)। এই অনুরোধগুলো টোকেন খরচ করে না।

ত্রুটি: কী ছাড়া — 401 authentication_error, ভুল প্যারামিটার — 400 validation_error, API কী সহ কেবিনেট রুট — 403 forbidden।

GET /api/balance#

বর্তমান ব্যালেন্স।

ফিল্ডবিবরণ
balance_ngonkanGNK-এ ব্যালেন্স — নির্ভুলতা না হারাতে স্ট্রিং হিসেবে
balance_usdবর্তমান রেটে ডলারে ব্যালেন্স
cost_per_token_ngonkaপ্রস্তাবিত মডেলের ইনপুট টোকেনের দাম মার্কআপ সহ, nGNK
tokens_remainingএই দামে ব্যালেন্স দিয়ে কত ইনপুট টোকেন চালানো যাবে — একটি আনুমানিক হিসাব
cURL
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

GET /api/usage#

দৈনিক খরচ: অনুরোধ, টোকেন, খরচ।

  • period — day, week, month, quarter, ডিফল্ট month।
  • অথবা from এবং to YYYY-MM-DD ফরম্যাটে, দুটোই একসাথে, 92 দিন পর্যন্ত — তখন উত্তরে period: custom।
  • tz — মিনিটে অফসেট, ব্রাউজারের getTimezoneOffset() এর মতো: UTC+3 এর জন্য — -180। এটি না দিলে — UTC।

উত্তর — date, requests, tokens, costNgonka ফিল্ডসহ দিনের অ্যারে। অনুরোধের বিস্তারিত রেকর্ড 90 দিন সংরক্ষিত থাকে।

cURL
curl -s "https://gate.joingonka.ai/api/usage?period=week&tz=-180" \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"

GET /api/usage/by-model#

মডেল অনুযায়ী খরচ: models-এ মোট এবং series-এ «পিরিয়ড × মডেল» সিরিজ — period=day হলে ঘণ্টা, নাহলে দিন। প্যারামিটার — /api/usage এর মতো।

GET /api/usage/by-key#

কী অনুযায়ী খরচ — keys। প্যারামিটার — /api/usage এর মতো।

GET /api/transactions#

লেনদেনের ইতিহাস: ডিপোজিট, অনুরোধের জন্য চার্জ, বোনাস, উইথড্র।

  • limit — সর্বোচ্চ 200, ডিফল্ট 50; offset — অফসেট।
  • type — ফিল্টার: DEPOSIT_USDT, DEPOSIT_GNK, DEPOSIT_FIAT, INFERENCE, REFERRAL_REWARD, BONUS, WITHDRAWAL।
  • from এবং to — তারিখ, শেষ দিনসহ।

উত্তর — id, type, amountNgonka, feeNgonka, description, createdAt ফিল্ডসহ রেকর্ড এবং মোট সংখ্যা total। INFERENCE রেকর্ড 90 দিনের পুরনো হলে প্রতিদিনের জন্য একটিতে মিলিয়ে দেওয়া হয়।

GET /api/deposits#

শুধু ডিপোজিট। প্যারামিটার limit, offset, from এবং to — লেনদেনের ইতিহাসের মতোই; উত্তরে total আছে।

POST /api/deposit/gnk#

GNK ডিপোজিটের বিবরণ: address এবং memo। এই memo দিয়ে এই ঠিকানায় GNK পাঠান — জমা স্বয়ংক্রিয়ভাবে হবে।

GET /api/deposit/usdt/rate#

USDT ডিপোজিটের রেট এবং ফি: gnk_usd_price, fee_percent, fee_tiers।

POST /api/deposit/usdt#

USDT-তে পেমেন্ট ইনভয়েস: বডি {"amount": 25} — 1 থেকে 10000 ডলারের পরিমাণ; উত্তরে payment_url। USDT গ্রহণ সাময়িকভাবে বন্ধ থাকলে — 503।

GET /api/pricing#

কী ছাড়াই দাম এবং ফি: models[], deposit_usdt_fee_tiers, GNK রেট এবং রেজিস্ট্রেশনে বোনাস।

শুধু ড্যাশবোর্ডে#

অ্যাকাউন্ট ম্যানেজমেন্ট — gate.joingonka.ai/dashboard ড্যাশবোর্ডে। এই রুটগুলো ইন্টিগ্রেশনের জন্য নয়, এর কয়েকটি API কী-তে 403 forbidden রেসপন্স দেয়:

  • API কী — gate.joingonka.ai/keys;
  • GNK উইথড্র — 1 GNK থেকে;
  • কার্ডে ডিপোজিট এবং WGNK প্রেরকের ঠিকানা;
  • প্রোমো কোড;
  • রেফারেল প্রোগ্রাম এবং নিউজলেটার সেটিংস।