OpenAI API Key 费用归因现已可编程：每个路由运营商必须做出的改变

OpenAI 8 月 4 日的更新日志条目容易被忽视：用户现在可以在平台看板中按 API Key 过滤和分组用量与费用数据，同一个 api_key 维度也可通过用量 API 和费用 API 以编程方式获取。

对于通过单一 OpenAI 组织路由 AI 流量、但使用多个 API Key 的团队而言——一个 Key 对应一个环境、一个对应下游模型回退路径、一个对应客户工作区——这改变了费用问责体系的构建方式。此前需要创建独立组织才能实现的费用细分，现在只需一个查询参数。

8 月 4 日实际发生了什么

两个端点新增了 api_key 分组维度：

• 用量 API（/v1/organization/usage）：支持对补全数、Token 数和请求数按 group_by=api_key 分组。
• 费用 API（/v1/organization/costs）：支持按 group_by=api_key 汇总 USD 消费。

platform.openai.com/settings/organization/usage 的看板提供了同样的过滤功能——选择指定 Key 即可隔离其费用贡献。

无需迁移。已在使用这些 API 的团队无需修改请求结构即可获得新维度。如果你今天已在使用 /v1/organization/usage，直接在现有请求中追加 &group_by=api_key 即可。

为何 AI 网关运营商必须关注

路由网关通常在同一 OpenAI 组织下运行，但会为不同目的签发不同的 API Key。常见模式包括：

• 环境隔离：生产、测试、开发各一个 Key。在收到账单之前，你需要知道生产环境消耗了月度费用的 92%。
• 按客户计费：将 OpenAI 费用预先计入客户账户的 SaaS 团队。若无 Key 归因，核对哪个租户产生了哪些费用，需要依赖下游的请求级日志汇总。
• 模型回退路径：主路径使用 GPT-5.6 Sol，路由器回退时使用 GPT-5.6 Luna 的 Key。了解回退发生的频率及其费用，是制定路由策略的重要依据。

8 月 4 日之前，在 API 层面实现这种隔离的唯一方式是创建独立的 OpenAI 组织——每个组织有独立的计费、速率限制和管理开销。实际结果是，大多数路由团队放弃了按 Key 归因，转而在下游自行汇总日志。

这填补了跨提供商的哪个空白

在单一组织内实现 API Key 归因并非普遍能力：

• Anthropic：不提供按 Key 的费用细分。要隔离各 Key 的费用，必须创建独立的 Anthropic 工作区，每个工作区有独立的计费和速率限制。
• Google Vertex AI：以项目（Project）而非 API Key 作为费用隔离单元。无法按 Key 归因，最细粒度是按项目归因。
• Azure OpenAI / AI Foundry：以部署（Deployment）和资源组作为费用单元。资源组内的 API Key 归因在计费 API 中无法直接获取。

OpenAI 现在是唯一一家允许在单一组织内通过可编程 API 实现细粒度、按 Key 费用归因的主流提供商。这改变了多租户路由设计的推荐 Key 架构：不再有充分理由仅为了费用可见性而将生产流量拆分到多个组织。

路由策略变化：现在需要审查什么

1. Key 架构审查

如果你的网关过去因为需要费用隔离而使用了多个 OpenAI 组织，请评估单组织多 Key 设计是否已能达到同等目标。合并可以减少速率限制碎片化（速率限制按组织计算），并简化凭证管理。

2. 按 Key 的费用告警

结合 OpenAI 7 月 22 日发布的消费限额功能，费用 API 的 group_by=api_key 可以为每个路由 Key 设置月度硬性上限，确保某个异常 Agent 或意外流量峰值触发 429 而非无边界账单。

# 示例：获取过去 30 天各 Key 的费用
import httpx

r = httpx.get(
    "https://api.openai.com/v1/organization/costs",
    params={
        "start_time": "2026-07-07T00:00:00Z",
        "end_time": "2026-08-07T00:00:00Z",
        "group_by": "api_key",
    },
    headers={"Authorization": f"Bearer {admin_key}"},
)
for bucket in r.json()["data"]:
    print(bucket["api_key_id"], bucket["amount"]["value"])

注意：组织级费用查询需要 Admin API Key，而非项目 Key。

3. 回退路径费用可见性

如果你的路由器对回退模型使用了独立的 API Key，group_by=api_key 的细分数据现在可以告诉你：本月回退发生了多少次，费用是多少。这是调整回退阈值策略的直接依据——如果回退费用超过阈值，就收紧主模型的重试预算，或切换到更低成本的回退方案。

4. 账单对账频率

费用数据可编程获取后，你可以自动化月度客户对账流程，而无需依赖平台看板。每月初拉取费用 API、按客户 Key 分组，将结果直接输入计费系统。

TheRouter 用户需要关注的内容

TheRouter 通过提供商专属 API Key 路由请求。OpenAI 的按 Key 费用细分意味着，你现在可以将 TheRouter 的路由日志（哪条路径触发、使用了哪个模型、是否发生回退）与费用 API 中的按 Key 费用数据交叉对比，无需额外日志汇总即可获得完整的路径级费用视图。在 TheRouter 中配置 OpenAI Key 时，建议主路径和回退路径使用不同的 Key——新 API 会自动完成费用归因。