AI エージェント向け：セットアップの手順ガイド — /docs/agents.md、ドキュメントのインデックス — /llms.txt。
料金とアカウント
モデルの料金、入金・出金手数料、GNK レート。キーによるアカウント API：残高、日別・モデル別の利用額、取引履歴、入金履歴。
モデル価格#
価格にはプラットフォーム手数料 10% が既に含まれています。最新の値は GET /api/pricing で確認できます (キー不要)。
model | 入力、100 万トークンあたり $ | 出力、100 万トークンあたり $ | トークンあたり 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 手数料ティア。 |
| 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_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日より古いレコードは1日単位でまとめられます。
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送金元アドレス；
- プロモコード；
- 紹介プログラムとメール配信設定。