Skip to main content
这是 Routing Studio 的简化的、以密钥为中心的入口。客户从不会看到”偏好设置”对象——服务端会在后台自动查找或创建一个隐藏的按密钥偏好设置,并确保绑定行指向它。 当你要调优单个 API 密钥时,请使用此端点。当你想要一套跨多个密钥共享的规则集、或作为团队默认设置时,请改用 /api/v1/routing-preferences。

认证

需要具有 billing API 密钥作用域的 Bearer 令牌,并且需要有权访问该密钥(调用者拥有该密钥,或通过其所在的活跃组织获得访问权限)。

GET

读取该密钥的规则以及已解析的绑定状态。

响应

  • active: true —— 这些规则当前正驱动该密钥的补全请求。
  • active: false —— 该密钥继承了默认设置(或绑定到了某个共享偏好设置);规则仍可编辑,但在保存之前或共享绑定被清除之前不会生效。
  • shared_binding —— 当该密钥绑定到某个共享偏好设置(而非其隐藏行)时会填充此字段。此时应将共享规则渲染为只读,并提供一个”在此密钥上覆盖”按钮。

PUT

替换按密钥的规则/示例/覆盖项。该路由会自动查找或创建隐藏的偏好设置,并确保绑定指向它。
object[]
最多 50 条规则。结构与 routing-preferences 相同。
object[]
最多 30 个少样本(few-shot)示例。
object
按模式设置的置信度下限覆盖项。

DELETE

清除按密钥的规则:删除绑定,使解析级联回退到组织默认 → 用户默认 → 无,并删除隐藏的偏好设置行。指向非隐藏(共享)偏好设置的现有绑定不受影响。

错误

  • 400 routing_preference_invalid —— 校验失败(例如出现供应商名称、正则表达式无法编译等)。
  • 404 not_found —— 密钥不存在、已被吊销,或调用者无权访问。