لعملاء الذكاء الاصطناعي: تعليمات الإعداد خطوة بخطوة — /docs/agents.md، فهرس الوثائق — /llms.txt.
الأسعار والحساب
أسعار النماذج، وعمولات الإيداع والسحب، وسعر صرف GNK. واجهة API للحساب عبر المفتاح: الرصيد، والإنفاق حسب اليوم والنموذج، وسجل العمليات وعمليات الإيداع.
أسعار الموديلات#
الأسعار تشمل بالفعل هامش المنصة 10%. والقيم الحية في GET /api/pricing، بلا مفتاح.
model | الإدخال، $ لكل 1M رمز | الإخراج، $ لكل 1M رمز | nGNK لكل رمز: إدخال / إخراج |
|---|---|---|---|
MiniMaxAI/MiniMax-M2.7 | $0.008349 | $0.02505 | 33 / 99 |
deepseek-ai/DeepSeek-V4-Flash-0731 | $0.008349 | $0.02505 | 33 / 99 |
zai-org/GLM-5.3-Flash | $0.008349 | $0.02505 | 33 / 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. |
| شحن WGNK من Ethereum | 1% | يغطي رسوم شبكة Ethereum عند التحويل إلى Gonka. |
| سحب 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_ngonka | الرصيد بـnGNK — كنص للحفاظ على الدقة |
balance_usd | الرصيد بالدولار وفق السعر الحالي |
cost_per_token_ngonka | سعر رمز الإدخال للموديل الموصى به مع الهامش، بـnGNK |
tokens_remaining | كم عدد رموز الإدخال التي يكفيها الرصيد بهذا السعر — تقدير |
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 -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. حوّل GNK إلى هذا العنوان مع هذا memo — الإضافة تلقائية.
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؛
- أكواد الخصم؛
- برنامج الإحالة وإعدادات الرسائل.