# 課金と credits

実際に返された回答にのみ課金します。開始時に「prompt × エンジン × サンプル数」分を仮押さえし、終了後に精算します。credits は買い切りで有効期限はありません。

| 呼び出し | 回答ごとの消費 |
| --- | --- |
| GEO データ・標準エンジン（chatgpt、google-aio、chatgpt-api、perplexity、grok） | 1 |
| GEO データ・高コストエンジン（gemini、gemini-api、claude） | 2 |
| Index 分析（/v1/geo/index が回答ごとに KPI を計算） | +1 |
| キャッシュヒット | 0 |
| エンジンのタイムアウト・失敗・回答なし | 0 |
| 503 engines_unavailable（指定エンジンがすべて利用不可） | 0 |
| /v1/geo/index/summary、/v1/jobs、/v1/account、/v1/status | 0 |

### レスポンスヘッダー

| ヘッダー | 意味 |
| --- | --- |
| `x-credits-used` | このリクエストで実際に消費した credits |
| `x-credits-remaining` | 消費後の残高 |
| `x-cache` | hit・miss・partial（一部の回答のみヒット） |

### キャッシュ

キャッシュキーは prompt + エンジン + 地域 + 言語 + サンプル番号。有効期間 24 時間、アカウント間で共有。fresh: true でキャッシュを使わず通常料金で実行。