概览

Sluiceline 位于你的应用与已有的 AI 供应商之间。真实供应商密钥托管在这里， 应用改用不透明的 safe-key（sk-safe-…）调用网关。网关执行配额与每访客限额， 再用真实密钥转发到供应商。

请求流程

1. 应用按供应商原本的格式把请求发到网关，凭据是 safe-key。
2. 网关解析该 safe-key：它指向哪个平台、处于哪种模式、适用哪些配额。
3. Safe 模式解密真实密钥、替换凭据，并把供应商的响应原样流式返回。
4. Mock 模式返回与供应商格式一致的响应，完全不联系供应商。

响应结构、流式格式与错误形态全部保持供应商原生，SDK 感知不到中间多了一层。

两种模式

模式是密钥自身的属性，与 URL 无关：前缀决定平台，凭据决定模式。详见 Safe 与 Mock。

代码需要改什么

两个值：

请求体、流式、重试与错误处理全部不变。一键切换 列出了各平台的 base URL 与凭据请求头。

接下来

• 快速开始 —— 通过网关发出第一次请求。
• 凭据 —— 各平台使用的请求头。
• 配额与限流 —— PV 与 UV 如何保护真实密钥。
• 错误 —— 网关返回的全部状态码。