模型与路由
治理与路由模拟
在不授予推理权限的情况下检查有界证据
治理读取和路由模拟使用与 route scope 刻意分离的凭据。它们提供无内容的租户证据与路由规划,不是生成历史或消费者计费账本。
读取租户治理摘要
GET /v1/governance/summary 需要 governance:read、admin 或 *,并始终使用验证凭据绑定的租户。event_limit 范围为 1–200;可选 key_id 是非 Secret 的安全服务密钥过滤条件。
GET https://api.octoryn.dev/v1/governance/summary?event_limit=50
Authorization: Bearer $OCTORYN_GOVERNANCE_KEY理解读取模型边界
响应包含精确字符串形式的租户预算状态、有界用量汇总、Key 归属与仅含元数据的审计事件。它会说明本地事件窗口是否不完整,且不会返回 Prompt、Output、原始 Token 或 Token Hash。
模拟路由
POST /v1/route/simulate 需要 route:simulate、admin 或 *。它评估身份、产品、策略、目录、健康、熔断与供应商偏好,但不会解析供应商凭据、预留预算或调用供应商。
POST https://api.octoryn.dev/v1/route/simulate?operation=chat
Authorization: Bearer $OCTORYN_SIMULATION_KEY
Content-Type: application/json
{"model":"policy/frontier","provider":{"sort":"latency"}}不要把模拟视作资源预留
后续真实请求仍可能因预算、容量或供应商可用性失败。Simulation 是解释和审查能力,不是保证,也不是带内容的 Dry Run。
