# 課金と返金

対話・画像・動画の課金方法、確保額の精算、課金されないケース、利用額の確認、チャージと返金の方法。

> https://nezhagate.com/ja/docs/guide/billing

## クレジット

残高はクレジットで表示され、1 米ドル = 200 クレジットです。料金ページとドキュメントの価格は米ドル建てで、課金時にこのレートでクレジットに換算します。`/v1/usage` は米ドルの残高とクレジットの両方を返します。

## モデルの種類ごとの課金方法

| 種類 | 課金単位 | 補足 |
| --- | --- | --- |
| **対話** | トークン単位：入力と出力で別々の料金（100 万トークンあたりの米ドル） | キャッシュヒットはより安いキャッシュ読み取り料金、思考トークンは出力料金で課金します。 |
| **画像** | 1 枚ごと、解像度のグレード（1K / 2K / 4K）ごとの料金 | 実際に納品した枚数分だけ課金し、失敗した分は無料です。 |
| **動画** | ほとんどは秒単位（単価 × 長さ）、一部のモデルは 1 本ごと | 秒単位か 1 本ごとかは、料金ページと各モデルのドキュメントに記載しています。 |

[各モデルの料金 →](https://nezhagate.com/ja/pricing)

## 対話の課金の詳細

- `usage.prompt_tokens` が入力、`usage.completion_tokens` が出力です。キャッシュヒットした部分は、別途キャッシュ読み取り料金で課金します。

- 推論モデルの思考トークンは出力に含まれ、思考の内容を読むかどうかに関係なく出力料金で課金します。ほとんどのモデルは、その数を `usage.completion_tokens_details.reasoning_tokens` で返します。

- ストリーミングが途中で切れた場合は、切れるまでに生成された分だけを課金し、回答全体の料金はかかりません。

- Claude のプロンプトキャッシュには「キャッシュ書き込み」の料金もあります。各モデルのキャッシュ読み取り・書き込みの料金は、そのモデルのドキュメントと料金ページに載っています。

## 確保と精算

- リクエストを実行する前に、見積額を残高から確保します。残高が足りなければ 402 `insufficient_quota` が返り、モデルは呼び出されません。

- 対話は実際の使用量で精算し、確保額の残りを返します。画像は納品した枚数で、動画は注文した長さまたは本数（確保額と同じ）で精算します。

- 同時に実行するリクエストが多いほど、確保される額も増えます。残高に余裕がないと確保のために 402 が返ることがありますが、先のリクエストが精算されれば解消します。

## 失敗は課金されません

失敗したリクエストは一切課金されません。上流のエラー、タイムアウト、コンテンツ審査による拒否、ゲートウェイのエラーのいずれでも同じです。非同期タスクが失敗した場合は確保額が自動で全額戻り、理由はコールログに記録されます。

## 別のモデルが回答する場合

一部の対話モデルが一時的に使えないとき、リクエストが失敗しないよう、ゲートウェイが別のモデルに回答させることがあります。その場合は 2 つのモデルのうち安いほうの料金で課金し、どのモデルが回答し、どの料金を適用したかをコールログに記載します。

## 利用額の確認

- コンソールの「コールログ」：直近 60 日間のすべての呼び出しについて、モデル、所要時間、使用量、課金額を表示します。失敗した呼び出しには理由も表示されます。

- コンソールの「使用量」：日別・モデル別・キー別の集計を表示し、CSV にエクスポートできます。

- プログラムから：`GET /v1/usage` が残高、累計と今日の利用額、モデル別の利用状況を返します。詳しくは [API リファレンス](https://nezhagate.com/ja/docs/api#balance) をご覧ください。

## チャージと返金

チャージはコンソールの「請求」ページで行います。WeChat Pay なら ¥10（260 クレジット）から、USDT やカードなら $5 からです。クレジットに有効期限はありません。登録時と初回チャージ時の特典は [よくある質問](https://nezhagate.com/ja/faq#credits-expire) で説明しています。

チャージから 7 日以内であれば、未使用の購入クレジットはサポート経由で返金でき、返金 1 件ごとに $0.40 の手数料がかかります。特典クレジットは返金対象外です。USDT での支払いも返金できます。
