> AI エージェント向け：セットアップの手順ガイド — [`/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` | 入力、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 手数料ティア](https://gate.joingonka.ai/ja/docs/billing#usdt-tiers)。 |
| 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` | この価格で残高でまかなえる入力トークン数の目安 |

```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日より古いレコードは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](https://gate.joingonka.ai/dashboard)の管理画面で行います。これらのルートは連携用ではなく、一部はAPIキーに対して`403 forbidden`を返します：

- APIキー — [gate.joingonka.ai/keys](https://gate.joingonka.ai/keys)；
- GNKの出金 — 最低1 GNK；
- カード入金とWGNK送金元アドレス；
- プロモコード；
- 紹介プログラムとメール配信設定。