> لعملاء الذكاء الاصطناعي: تعليمات الإعداد خطوة بخطوة — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md)، فهرس الوثائق — [`/llms.txt`](https://gate.joingonka.ai/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](https://gate.joingonka.ai/ar/docs/billing#usdt-tiers). |
| شحن 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` | كم عدد رموز الإدخال التي يكفيها الرصيد بهذا السعر — تقدير |

```bash
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 يومًا.

```bash
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](https://gate.joingonka.ai/dashboard). هذه المسارات ليست للتكامل، وبعضها يرد على مفتاح API بـ `403 forbidden`:

- مفاتيح API — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys)؛
- سحب GNK — من 1 GNK؛
- الإيداع بالبطاقة وعناوين المرسلين بعملة WGNK؛
- أكواد الخصم؛
- برنامج الإحالة وإعدادات الرسائل.