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 بھیجنے والوں کے ایڈریس;
  • پرومو کوڈز;
  • ریفرل پروگرام اور نیوز لیٹر کی سیٹنگز۔