Appearance
OpenRouter 企业版快速入门指南,覆盖六个关键配置阶段:①组织创建(共享 credits、RBAC、用量统计)→ ②Management API Key 自动化管理(零停机轮换)→ ③安全控制(Guardrails 限额/模型白名单、ZDR 零数据保留、数据隐私)→ ④可观测性(Broadcast 自动发送 trace、User Tracking 用户级分析)→ ⑤用量监控(每次响应含 token 计数和费用、CSV/PDF 导出)→ ⑥可靠性优化(provider 自动路由故障转移)。企业版还支持 EU 区域路由,保证数据不出 EU。
OpenRouter 企业版为团队提供共享 credits、集中化 API Key 管理和统一用量追踪。
第一步:创建组织
前往 Settings > Preferences,点击 Create Organization。创建完成后可邀请团队成员,通过组织切换器在个人账号和组织账号之间切换。
核心能力:
- 共享 credits 池:集中计费,无需为每个成员单独充值
- 角色权限控制:Admin 和 Member 两种角色
- 组织级用量追踪:统一查看所有成员的 API 使用情况
完整配置详见 Organization Management。
第二步:配置 API Key 管理
Management API Keys
创建 Management API Key 以编程方式管理 API Key,实现:
- 自动为客户实例创建独立 key
- 按安全合规要求定期轮换
- 配置用量上限并监控超额
完整 API 参考见 Management API Keys。
API Key 零停机轮换
推荐的轮换流程:
- 用 Management API 创建新 key
- 更新应用配置,指向新 key
- 删除旧 key
如果使用了 BYOK(Bring Your Own Key),轮换 OpenRouter API Key 时不需要变动 provider 凭证,大幅简化密钥管理。
第三步:安全控制
Guardrails(访问限制)
Guardrails 让组织管理员控制成员和 API Key 的使用边界:
- 消费限制:按日/周/月设置上限
- 模型/provider 白名单:限制只能使用指定的模型或 provider
- 强制 ZDR:对敏感工作负载开启零数据保留
Guardrails 可绑定到组织成员(作为该成员所有 key 的基准)或直接绑定到特定 API Key(粒度更细)。多个 Guardrails 叠加时,更严格的规则优先。
详见 Guardrails。
Zero Data Retention(ZDR)
ZDR 确保 provider 不存储你的 prompt 和响应。
在 隐私设置 中全局开启,或在单次请求中指定:
json
{
"model": "meta-llama/llama-3.3-70b-instruct",
"messages": [{ "role": "user", "content": "Hello" }],
"provider": {
"zdr": true
}
}OpenRouter 自身也有 ZDR 政策,除非你主动开启 prompt 日志,否则不存储任何 prompt 内容。
数据隐私
OpenRouter 默认不存储 prompt 和响应,只保留元数据(token 计数、延迟等)用于报表和活动记录。详见 Data Collection 和 Provider Logging。
第四步:配置可观测性
Broadcast
Broadcast 自动将每次 OpenRouter 请求的 trace 发送到外部可观测性平台,无需额外埋点。
支持的目标:Datadog、Langfuse、LangSmith、Braintrust、OpenTelemetry Collector、S3 等。
前往 Settings > Observability 配置:
- 按 API Key 过滤 trace
- 设置采样率
- 最多配置 5 个同类型目标(适合区分不同环境)
详见 Broadcast。
User Tracking
在 API 请求中传入 user 参数:
json
{
"model": "openai/gpt-4o",
"messages": [...],
"user": "user_12345"
}好处:
- 按用户维度分析 token 用量
- 提升 prompt caching 命中率(同一用户的请求优先路由到同一 provider)
详见 User Tracking。
第五步:监控用量与费用
实时用量数据
每次 API 响应包含完整用量信息:
- Token 计数(prompt、completion、reasoning、cached)
- 费用(以 credits 计)
- 时延数据
无需额外 API 调用,直接从响应中读取。详见 Usage Accounting。
活动导出
在 Activity 页面 导出 CSV 或 PDF:
- 按时间段筛选
- 按模型、API Key 或成员分组
第六步:可靠性优化
Provider 路由与故障转移
OpenRouter 实时监控 provider 健康状态,自动绕过故障节点。可配置多模型 fallback 链,并按费用、延迟或特定 provider 偏好自定义路由策略。
详见 Provider Selection 和 Model Fallbacks。
常见问题
Q: EU 区域路由如何使用?
A: 企业客户可申请开启 EU 区域路由,请求保证仅在 EU 境内解密并路由到 EU provider,prompt 和响应全程不出 EU。使用方式:将 API base URL 改为 https://eu.openrouter.ai/api/v1。需联系 企业团队 申请开通。
Q: Guardrails 和 API Key 权限有什么区别?
A: API Key 的权限控制比较基础(如读写权限);Guardrails 提供更细粒度的业务层面限制,如"这个 Key 每天最多消费 $10"、"只能用 Claude 系列模型"。两者互补,Guardrails 叠加在 API Key 权限之上。
Q: 如何验证 ZDR 是否生效?
A: 响应头中会包含 X-ZDR: true 标记(如果 provider 支持并确认了 ZDR)。也可在 Broadcast 的 trace 中查看 provider.zdr 字段确认。注意:并非所有 provider 都支持 ZDR,可在 ZDR 文档 查看兼容 provider 列表。