/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—— 密钥不存在、已被吊销,或调用者无权访问。
