> Pour les agents IA : guide de configuration étape par étape — [`/docs/agents.md`](https://gate.joingonka.ai/docs/agents.md), index de la documentation — [`/llms.txt`](https://gate.joingonka.ai/llms.txt).

# Tarifs et compte

Tarifs des modèles, frais de dépôt et de retrait, taux GNK. API du compte par clé : solde, dépenses par jour et par modèle, historique des opérations et des dépôts.

## Prix des modèles

Les prix incluent déjà la marge de la plateforme 10%. Les valeurs en direct sont sur `GET /api/pricing`, sans clé.

| `model` | Entrée, $ pour 1M de tokens | Sortie, $ pour 1M de tokens | nGNK par token : entrée / sortie |
| --- | ---: | ---: | ---: |
| `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 |

- Coût de la requête = tokens d'entrée × prix d'entrée + tokens de sortie × prix de sortie. Les raisonnements du modèle sont comptés comme tokens de sortie.
- Le débit se fait en GNK (1 GNK = 10⁹ `nGNK`) ; les prix en dollars suivent le taux du GNK $0.253.
- Avant la requête, la passerelle vérifie le solde par rapport à l'estimation du coût ; s'il est insuffisant — `402 insufficient_funds`.
- Après l'inscription, 0.1 GNK sont crédités sur le compte — environ 3M tokens au prix d'entrée.

## Commissions

| Opération | Commission | Remarque |
| --- | --- | --- |
| Marge sur les requêtes vers les modèles | 10% | Déjà incluse dans les prix ci-dessus. |
| Recharge en GNK | gratuit | Virement vers l'adresse de la passerelle avec votre `memo` ; crédit automatique. |
| Recharge en USDT | 5% → 2.5% | Paiement via OxaPay ; plus le montant est élevé, plus la commission est basse — [Paliers de commission USDT](https://gate.joingonka.ai/fr/docs/billing#usdt-tiers). |
| Recharge en WGNK depuis Ethereum | 1% | Couvre le gaz du réseau Ethereum lors du transfert vers Gonka. |
| Retrait de GNK | 5% | Uniquement depuis l'espace client, à partir de 1 GNK. |
| Taux du GNK | $0.253 | Sert au calcul des recharges et des prix en dollars ; mis à jour automatiquement. |

### Paliers de commission USDT

Le taux dépend du montant de la recharge, seuil inclus :

| Montant de la recharge | Commission |
| --- | ---: |
| à partir de $0 | 5% |
| à partir de $25 | 4.5% |
| à partir de $50 | 4% |
| à partir de $100 | 3.5% |
| à partir de $250 | 3% |
| à partir de $500 | 2.75% |
| à partir de $1000 | 2.5% |

## API du compte

Le solde, les dépenses et les recharges sont accessibles avec la même clé que les requêtes vers les modèles (`Authorization: Bearer jg-…`). Ces requêtes ne consomment pas de tokens.

Erreurs : sans clé — `401 authentication_error`, paramètres invalides — `400 validation_error`, route de l'espace client avec une clé API — `403 forbidden`.

### GET `/api/balance`

Solde actuel.

| Champ | Description |
| --- | --- |
| `balance_ngonka` | Solde en nGNK — sous forme de chaîne pour ne pas perdre en précision |
| `balance_usd` | Solde en dollars au taux actuel |
| `cost_per_token_ngonka` | Prix du token d'entrée du modèle recommandé avec marge, nGNK |
| `tokens_remaining` | Nombre de tokens d'entrée que le solde couvre à ce prix — estimation |

```bash
curl -s https://gate.joingonka.ai/api/balance \
  -H "Authorization: Bearer $JOINGONKA_API_KEY"
```

### GET `/api/usage`

Consommation par jour : requêtes, tokens, coût.

- `period` — `day`, `week`, `month`, `quarter`, par défaut `month`.
- Ou `from` et `to` au format `YYYY-MM-DD`, les deux ensemble, jusqu'à 92 jours inclus — la réponse contient alors `period: custom`.
- `tz` — décalage en minutes, comme `getTimezoneOffset()` dans le navigateur : pour UTC+3 — `-180`. Sans ce paramètre — UTC.

La réponse est un tableau de jours avec les champs `date, requests, tokens, costNgonka`. Les enregistrements détaillés des requêtes sont conservés 90 jours.

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

### GET `/api/usage/by-model`

Consommation par modèle : totaux dans `models` et série « période × modèle » dans `series` — heures si `period=day`, sinon jours. Paramètres identiques à `/api/usage`.

### GET `/api/usage/by-key`

Consommation par clé — `keys`. Paramètres identiques à `/api/usage`.

### GET `/api/transactions`

Historique des opérations : rechargements, débits pour les requêtes, bonus, retraits.

- `limit` — jusqu'à 200, par défaut 50 ; `offset` — décalage.
- `type` — filtre : `DEPOSIT_USDT`, `DEPOSIT_GNK`, `DEPOSIT_FIAT`, `INFERENCE`, `REFERRAL_REWARD`, `BONUS`, `WITHDRAWAL`.
- `from` et `to` — dates, fin incluse.

La réponse contient les enregistrements avec les champs `id, type, amountNgonka, feeNgonka, description, createdAt` et le nombre total `total`. Les enregistrements `INFERENCE` de plus de 90 jours sont regroupés en un seul par jour.

### GET `/api/deposits`

Rechargements uniquement. Paramètres `limit`, `offset`, `from` et `to` — identiques à l'historique des opérations ; la réponse contient `total`.

### POST `/api/deposit/gnk`

Coordonnées pour recharger en GNK : `address` et `memo`. Envoyez les GNK à cette adresse avec ce `memo` — le crédit est automatique.

### GET `/api/deposit/usdt/rate`

Taux et frais de rechargement USDT : `gnk_usd_price`, `fee_percent`, `fee_tiers`.

### POST `/api/deposit/usdt`

Facture à payer en USDT : corps `{"amount": 25}` — montant en dollars de 1 à 10000 ; la réponse contient `payment_url`. Si la réception d'USDT est temporairement fermée — `503`.

### GET `/api/pricing`

Prix et frais sans clé : `models[]`, `deposit_usdt_fee_tiers`, taux GNK et bonus à l'inscription.

### Uniquement dans l'espace client

La gestion du compte se fait dans l'espace client [gate.joingonka.ai/dashboard](https://gate.joingonka.ai/dashboard). Ces routes ne sont pas destinées aux intégrations ; certaines répondent à une clé API `403 forbidden` :

- clés API — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys) ;
- retrait de GNK — à partir de 1 GNK ;
- rechargement par carte et adresses des expéditeurs WGNK ;
- codes promo ;
- programme de parrainage et réglages des envois.