# 计费与 credits

只对实际返回的答案扣费；请求开始时按「prompt × 引擎 × 采样数」预占 credits，结束后多退少补。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 跳过缓存，按正常价格扣费。
