关于 omni-settings
omni-settings 提供经过身份验证的 API 端点,用于读取和修改 OmniRoute 的全局应用设置。覆盖提示词、推理预算、代理、数据库和功能标志等配置。
主要功能
- 01读取和更新全局设置
- 02配置系统提示词与推理预算
- 03管理代理和 IP 筛选
- 04查看和配置数据库选项
- 05导出和导入设置
适用场景
- 01通过 API 调整应用设置
- 02配置推理请求改写方式
- 03管理代理和访问筛选配置
- 04在不同配置间迁移设置
MCP 相关
README 提及 MCP 可访问性与压缩相关的设置 API,但未说明 MCP 服务或客户端接口。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cheaper-inference/ omniroute --skill omni-settings安装后在 Claude Code 中输入/omni-settings确认已加载。
附带文件references/endpoints.md
详细介绍
概述
读取和更新全局应用设置:系统提示词、思考预算、IP 过滤器、负载规则、组合默认值和登录要求配置。
身份验证
所有请求都需要有效的 Bearer 令牌或会话 Cookie。通过 POST /api/auth/login 获取令牌,或在本地开发时配置 REQUIRE_API_KEY=false。
端点
GET /api/settings/memoryPUT /api/settings/memoryGET /api/settings/qdrantPUT /api/settings/qdrantGET /api/settings/qdrant/healthPOST /api/settings/qdrant/searchPOST /api/settings/qdrant/cleanupGET /api/settings/qdrant/embedding-modelsGET /api/settingsPATCH /api/settingsPOST /api/settings/purge-request-historyGET /api/settings/compressionPUT /api/settings/compressionGET /api/settings/compression/mcp-accessibilityPUT /api/settings/compression/mcp-accessibilityGET /api/settings/payload-rulesPUT /api/settings/payload-rulesGET /api/settings/combo-defaultsGET /api/settings/proxyPATCH /api/settings/proxyPOST /api/settings/proxy/testPOST /api/settings/require-loginGET /api/settings/ip-filterPUT /api/settings/ip-filterGET /api/settings/piiPUT /api/settings/piiPOST /api/settings/pii/testGET /api/settings/system-promptPUT /api/settings/system-promptGET /api/settings/thinking-budgetPUT /api/settings/thinking-budgetGET /api/tagsGET /api/settings/quota-storePUT /api/settings/quota-storePOST /api/settings/purge-usage-historyGET /api/settings/authz-inventoryGET /api/settings/auto-disable-accountsPUT /api/settings/auto-disable-accountsGET /api/settings/background-degradationPOST /api/settings/background-degradationPUT /api/settings/background-degradationGET /api/settings/cache-configPUT /api/settings/cache-configGET /api/settings/cache-metricsDELETE /api/settings/cache-metricsGET /api/settings/cc-discovery-metricsGET /api/settings/compression/rulesGET /api/settings/compression/run-telemetryGET /api/settings/databasePUT /api/settings/databasePATCH /api/settings/databasePOST /api/settings/database/integrity-checkPOST /api/settings/database/refresh-statsGET /api/settings/database/vacuumPOST /api/settings/database/vacuumGET /api/settings/export-jsonGET /api/settings/faviconGET /api/settings/feature-flagsPUT /api/settings/feature-flagsDELETE /api/settings/feature-flagsGET /api/settings/free-proxiesDELETE /api/settings/free-proxiesPOST /api/settings/free-proxies/{id}/add-to-poolPOST /api/settings/free-proxies/bulk-add-to-poolGET /api/settings/free-proxies/statsPOST /api/settings/free-proxies/syncPOST /api/settings/import-jsonDELETE /api/settings/lkgp-cacheGET /api/settings/local-corpusPOST /api/settings/local-corpusDELETE /api/settings/local-corpusGET /api/settings/mitmPOST /api/settings/mitmPUT /api/settings/mitmGET /api/settings/model-aliasesPOST /api/settings/model-aliasesPUT /api/settings/model-aliasesDELETE /api/settings/model-aliasesGET /api/settings/models-devPOST /api/settings/models-devGET /api/settings/notionPOST /api/settings/notionDELETE /api/settings/notionGET /api/settings/obsidianPOST /api/settings/obsidianDELETE /api/settings/obsidianGET /api/settings/obsidian/webdavPOST /api/settings/obsidian/webdavDELETE /api/settings/obsidian/webdavGET /api/settings/oneproxyPOST /api/settings/oneproxyDELETE /api/settings/oneproxyPOST /api/settings/oneproxy/rotateGET /api/settings/proxiesPOST /api/settings/proxiesPATCH /api/settings/proxiesDELETE /api/settings/proxiesPOST /api/settings/proxies/{id}/repair-relayGET /api/settings/proxies/assignmentsPUT /api/settings/proxies/assignmentsPOST /api/settings/proxies/auto-testPOST /api/settings/proxies/batch-activatePOST /api/settings/proxies/batch-deletePUT /api/settings/proxies/bulk-assignPOST /api/settings/proxies/bulk-importGET /api/settings/proxies/egressPOST /api/settings/proxies/egressGET /api/settings/proxies/healthPOST /api/settings/proxies/migrateGET /api/settings/proxies/poolPUT /api/settings/proxies/poolPATCH /api/settings/proxies/poolDELETE /api/settings/proxies/poolGET /api/settings/proxies/pool/egress-observationPOST /api/settings/proxy/cloudflare-deployPOST /api/settings/proxy/deno-deployPOST /api/settings/proxy/vercel-deployPOST /api/settings/purge-call-logsPOST /api/settings/purge-detailed-logsPOST /api/settings/purge-logsPOST /api/settings/purge-quota-snapshotsGET /api/settings/quota/statePOST /api/settings/quota/stateGET /api/settings/reasoning-routing-rulesPOST /api/settings/reasoning-routing-rulesGET /api/settings/reasoning-routing-rules/{id}PATCH /api/settings/reasoning-routing-rules/{id}DELETE /api/settings/reasoning-routing-rules/{id}POST /api/settings/reasoning-routing-rules/simulateGET /api/settings/task-routingPOST /api/settings/task-routingPUT /api/settings/task-routingGET /api/settings/tier-configPUT /api/settings/tier-configGET /api/settings/transfer/catalogPOST /api/settings/transfer/exportPOST /api/settings/transfer/previewPOST /api/settings/transfer/import
负载
如需查看详细的请求/响应架构,请参阅 GET /api/openapi/spec 或 docs/openapi.yaml 中的完整 OpenAPI 规范。
GET /api/settings/thinking-budget — 行为
返回代理级别的思考/推理请求重写设置:
| 字段 | 含义 |
|---|---|
mode | passthrough(保留客户端的推理设置——Codex 可见思考必需)、auto(移除所有客户端思考字段)、custom、adaptive |
customBudget | mode=custom 时的固定预算 |
effortLevel | mode=adaptive 时的基础工作强度 |
不是压缩,也不是“解密加密推理”。完整指南:docs/guides/THINKING_BUDGET.md。
示例 — 保留由客户端控制的推理(Codex/桌面客户端):
curl -X PUT https://localhost:20128/api/settings/thinking-budget \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"mode":"passthrough","customBudget":10240,"effortLevel":"medium"}'
警告:mode=auto 会在转发到上游之前,从出站请求体中删除 reasoning / reasoning_effort / Claude thinking。即使客户端请求了 Ultra + summary,也可能导致思考面板为空。
评论
支持 Markdown