Enterprise Quickstart
让你的组织开始使用 OpenRouter
原文链接:https://openrouter.ai/docs/cookbook/get-started/enterprise-quickstart
1. 设置你的组织
组织使团队能够通过共享积分、集中式 API key 管理和统一使用跟踪进行协作。
要创建组织,请导航到 Settings > Preferences 并点击 Create Organization。创建后,你可以邀请团队成员并使用组织切换器在个人和组织上下文之间切换。
关键组织功能包括用于集中计费的共享积分池、基于角色的访问控制(Admin 和 Member 角色)以及组织范围的活动跟踪。
有关组织设置和管理的完整详细信息,请参阅 Organization Management 指南。
2. 配置 API Key 管理
企业部署通常需要编程式 API key 管理,以实现自动化配置、轮换和生命周期管理。
管理 API Keys
创建一个 Management API key 以编程方式管理 API keys。这使得以下功能成为可能:为客户实例自动创建 key、为安全合规性编程式轮换 key、以及具有自动限制强制执行的用量监控。
请参阅 Management API Keys 以获取完整的 API 参考和代码示例。
API Key 轮换
定期轮换 key 以限制泄露凭据的影响。OpenRouter 的 Management API 支持零停机轮换:创建一个新 key,更新你的应用程序,然后删除旧 key。
如果你使用 BYOK (Bring Your Own Key),你可以轮换 OpenRouter API keys 而无需触及你的 provider 凭据,简化了 key 管理。
请参阅 API Key Rotation 以获取分步说明。
3. 实施安全控制
Guardrails
Guardrails 允许组织控制成员和 API keys 如何使用 OpenRouter。配置每日、每周或每月重置的支出限制、模型和 provider 允许列表以限制访问、以及敏感工作负载的零数据保留强制执行。
Guardrails 可以分配给组织成员(所有 their keys 的基线)或直接分配给特定 API keys 以进行细粒度控制。当多个 guardrails 适用时,更严格的规则总是胜出。
请参阅 Guardrails 以获取配置详情,以及 Guardrails API reference 以获取编程式管理。
Zero Data Retention (ZDR)
零数据保留确保 providers 不会存储你的 prompts 或响应。在你的 privacy settings 中全局启用 ZDR,或使用 zdr 参数按请求启用。
OpenRouter 本身有 ZDR 策略,除非你明确选择加入 prompt logging,否则不会保留你的 prompts。
请参阅 Zero Data Retention 以获取 ZDR 兼容 endpoints 和配置选项的完整列表。
数据隐私
除非你选择加入 prompt logging,否则 OpenRouter 不会存储你的 prompts 或响应。只有元数据(token 计数、延迟等)被存储用于报告和你的活动源。
请参阅 Data Collection 和 Provider Logging 以获取完整的隐私文档。
4. 设置可观察性
Broadcast
Broadcast 自动将来自你 OpenRouter 请求的 traces 发送到外部可观察性平台,无需额外的检测。支持的 destinations 包括 Datadog、Langfuse、LangSmith、Braintrust、OpenTelemetry Collector、S3 等。
在 Settings > Observability 配置 broadcast。你可以按 API key 过滤 traces、设置采样率,并配置最多 5 个相同类型的 destinations 以适应不同的环境。
请参阅 Broadcast 以获取设置说明和特定于 destination 的演练。
用户跟踪
通过在 API 请求中包含 user 参数来跟踪你的最终用户。这提高了缓存性能(每个用户的粘性路由)并在你的活动源和导出中启用用户级分析。
请参阅 User Tracking 以获取实现详情。
5. 监控使用情况和成本
使用量核算
每个 API 响应都包含详细的使用信息:token 计数(prompt、completion、reasoning、cached)、credits 成本和计时数据。这实现了实时成本跟踪,无需额外的 API 调用。
请参阅 Usage Accounting 以获取响应格式详情和代码示例。
活动导出
从 Activity page 导出聚合的使用数据为 CSV 或 PDF。按时间周期过滤,按 Model、API Key 或 Creator(组织成员)分组以获取详细报告。
请参阅 Activity Export 以获取导出说明。
6. 优化可靠性
Provider 路由和 Fallbacks
OpenRouter 实时监控 provider 健康状况,并自动绕过中断。通过指定多个模型配置 fallback chains,并根据成本、延迟或特定 provider 偏好自定义 provider 选择。
请参阅 Provider Selection 和 Model Fallbacks 以获取配置选项。
正常运行时间优化
OpenRouter 跨所有 providers 跟踪响应时间、错误率和可用性。这些数据为智能路由决策提供支持,并提供有关服务可靠性的透明度。
请参阅 Uptime Optimization 以获取有关 OpenRouter 如何最大化可用性的详细信息。
下一步
一旦你的组织配置完成,探索这些额外的资源:
- Quickstart — 基本 API 集成示例
- Structured Outputs — JSON schema 强制执行
- Tool Calling — 函数调用功能
- Prompt Caching — 成本优化
- Latency and Performance — 性能调优
有关企业销售咨询或自定义要求,请联系我们的销售团队:openrouter.ai/enterprise。