Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Welcome to Theo Docs — the AI orchestration API.
将已有的路由工作室偏好绑定到某个 API 密钥，或清除绑定。
/api/v1/keys/{id}/routing-rules。
将 preference_id 设为 null 即可清除绑定；此后该密钥在请求时将按顺序继承组织默认值 → 用户默认值 → 无。
billing API 密钥作用域的 Bearer 令牌，并且调用方需拥有对该密钥的访问权限（调用方本人拥有该密钥，或通过所在活跃组织获得访问权限）。
curl https://www.hitheo.ai/api/v1/keys/{id}/routing-preference \
-H "Authorization: Bearer $THEO_API_KEY"
const { preference_id, inherits_default } = await theo.keys.getRoutingPreference(keyId);
{
"key_id": "key_abc",
"preference_id": "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e",
"inherits_default": false
}
null 可清除绑定。# 绑定一个偏好
curl -X PUT https://www.hitheo.ai/api/v1/keys/{id}/routing-preference \
-H "Authorization: Bearer $THEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "preference_id": "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e" }'
# 清除绑定
curl -X PUT https://www.hitheo.ai/api/v1/keys/{id}/routing-preference \
-H "Authorization: Bearer $THEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "preference_id": null }'
await theo.keys.setRoutingPreference(keyId, "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e");
await theo.keys.setRoutingPreference(keyId, null); // 清除
400 routing_preference_not_bindable，并附带与厂商无关的提示信息。400 routing_preference_not_bindable — 该偏好对该密钥的作用域不可见。404 not_found — 密钥或偏好不存在（或调用方不可见）。此页面对您有帮助吗？