Pour les agents IA : guide de configuration étape par étape — /docs/agents.md, index de la documentation — /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. |
| 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 |
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éfautmonth.- Ou
fromettoau formatYYYY-MM-DD, les deux ensemble, jusqu'à 92 jours inclus — la réponse contient alorsperiod: custom. tz— décalage en minutes, commegetTimezoneOffset()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.
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.frometto— 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. 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 ;
- 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.