# API 限流与版本

将 `/v1` 作为当前路径契约，并依据响应头而非硬编码请求额度处理限制。

## 步骤

1. 记录状态、错误代码和 `x-request-id`。
2. 遇到 `429`，按 `Retry-After` 或 `x-ratelimit-reset` 等待。
3. 使用指数退避、随机抖动、最长等待和最多尝试次数。
4. 限制并发；没有安全重放说明时，不要重试非幂等操作。

## 预期结果

客户端可以从临时限制中恢复，避免重复工作，并明确报告不兼容路径。

> **注意：** `x-ratelimit-limit`、`x-ratelimit-remaining` 和 `x-ratelimit-reset` 可能动态变化或显示 `unlimited`。当前路由不要求另加公共版本请求头。