使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-settings开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
Overview
Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.
Authentication
All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.
Endpoints
- `GET /api/settings/memory`
- `PUT /api/settings/memory`
- `GET /api/settings/qdrant`
- `PUT /api/settings/qdrant`
- `GET /api/settings/qdrant/health`
- `POST /api/settings/qdrant/search`
- `POST /api/settings/qdrant/cleanup`
- `GET /api/settings/qdrant/embedding-models`
- `GET /api/settings`
- `PATCH /api/settings`
- `POST /api/settings/purge-request-history`
- `GET /api/settings/compression`
- `PUT /api/settings/compression`
- `GET /api/settings/compression/mcp-accessibility`
- `PUT /api/settings/compression/mcp-accessibility`
- `GET /api/settings/payload-rules`
- `PUT /api/settings/payload-rules`
- `GET /api/settings/combo-defaults`
- `GET /api/settings/proxy`
- `PATCH /api/settings/proxy`
- `POST /api/settings/proxy/test`
- `POST /api/settings/require-login`
- `GET /api/settings/ip-filter`
- `PUT /api/settings/ip-filter`
- `GET /api/settings/pii`
- `PUT /api/settings/pii`
- `POST /api/settings/pii/test`
- `GET /api/settings/system-prompt`
- `PUT /api/settings/system-prompt`
- `GET /api/settings/thinking-budget`
- `PUT /api/settings/thinking-budget`
- `GET /api/tags`
- `GET /api/settings/quota-store`
- `PUT /api/settings/quota-store`
- `POST /api/settings/purge-usage-history`
- `GET /api/settings/authz-inventory`
- `GET /api/settings/auto-disable-accounts`
- `PUT /api/settings/auto-disable-accounts`
- `GET /api/settings/background-degradation`
- `POST /api/settings/background-degradation`
- `PUT /api/settings/background-degradation`
- `GET /api/settings/cache-config`
- `PUT /api/settings/cache-config`
- `GET /api/settings/cache-metrics`
- `DELETE /api/settings/cache-metrics`
- `GET /api/settings/cc-discovery-metrics`
- `GET /api/settings/compression/rules`
- `GET /api/settings/compression/run-telemetry`
- `GET /api/settings/database`
- `PUT /api/settings/database`
- `PATCH /api/settings/database`
- `POST /api/settings/database/integrity-check`
- `POST /api/settings/database/refresh-stats`
- `GET /api/settings/database/vacuum`
- `POST /api/settings/database/vacuum`
- `GET /api/settings/export-json`
- `GET /api/settings/favicon`
- `GET /api/settings/feature-flags`
- `PUT /api/settings/feature-flags`
- `DELETE /api/settings/feature-flags`
- `GET /api/settings/free-proxies`
- `DELETE /api/settings/free-proxies`
- `POST /api/settings/free-proxies/{id}/add-to-pool`
- `POST /api/settings/free-proxies/bulk-add-to-pool`
- `GET /api/settings/free-proxies/stats`
- `POST /api/settings/free-proxies/sync`
- `POST /api/settings/import-json`
- `DELETE /api/settings/lkgp-cache`
- `GET /api/settings/local-corpus`
- `POST /api/settings/local-corpus`
- `DELETE /api/settings/local-corpus`
- `GET /api/settings/mitm`
- `POST /api/settings/mitm`
- `PUT /api/settings/mitm`
- `GET /api/settings/model-aliases`
- `POST /api/settings/model-aliases`
- `PUT /api/settings/model-aliases`
- `DELETE /api/settings/model-aliases`
- `GET /api/settings/models-dev`
- `POST /api/settings/models-dev`
- `GET /api/settings/notion`
- `POST /api/settings/notion`
- `DELETE /api/settings/notion`
- `GET /api/settings/obsidian`
- `POST /api/settings/obsidian`
- `DELETE /api/settings/obsidian`
- `GET /api/settings/obsidian/webdav`
- `POST /api/settings/obsidian/webdav`
- `DELETE /api/settings/obsidian/webdav`
- `GET /api/settings/oneproxy`
- `POST /api/settings/oneproxy`
- `DELETE /api/settings/oneproxy`
- `POST /api/settings/oneproxy/rotate`
- `GET /api/settings/proxies`
- `POST /api/settings/proxies`
- `PATCH /api/settings/proxies`
- `DELETE /api/settings/proxies`
- `POST /api/settings/proxies/{id}/repair-relay`
- `GET /api/settings/proxies/assignments`
- `PUT /api/settings/proxies/assignments`
- `POST /api/settings/proxies/auto-test`
- `POST /api/settings/proxies/batch-activate`
- `POST /api/settings/proxies/batch-delete`
- `PUT /api/settings/proxies/bulk-assign`
- `POST /api/settings/proxies/bulk-import`
- `GET /api/settings/proxies/egress`
- `POST /api/settings/proxies/egress`
- `GET /api/settings/proxies/health`
- `POST /api/settings/proxies/migrate`
- `GET /api/settings/proxies/pool`
- `PUT /api/settings/proxies/pool`
- `PATCH /api/settings/proxies/pool`
- `DELETE /api/settings/proxies/pool`
- `GET /api/settings/proxies/pool/egress-observation`
- `POST /api/settings/proxy/cloudflare-deploy`
- `POST /api/settings/proxy/deno-deploy`
- `POST /api/settings/proxy/vercel-deploy`
- `POST /api/settings/purge-call-logs`
- `POST /api/settings/purge-detailed-logs`
- `POST /api/settings/purge-logs`
- `POST /api/settings/purge-quota-snapshots`
- `GET /api/settings/quota/state`
- `POST /api/settings/quota/state`
- `GET /api/settings/reasoning-routing-rules`
- `POST /api/settings/reasoning-routing-rules`
- `GET /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/simulate`
- `GET /api/settings/task-routing`
- `POST /api/settings/task-routing`
- `PUT /api/settings/task-routing`
- `GET /api/settings/tier-config`
- `PUT /api/settings/tier-config`
- `GET /api/settings/transfer/catalog`
- `POST /api/settings/transfer/export`
- `POST /api/settings/transfer/preview`
- `POST /api/settings/transfer/import`
Payloads
See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.
<!-- skill:custom-start --> <!-- Thinking budget behavior (preserved curated content — #10169) -->
GET /api/settings/thinking-budget — behavior
Returns proxy-level thinking/reasoning request rewrite settings:
| Field | Meaning |
|---|---|
mode | passthrough (leave client reasoning alone — required for Codex visible thinking), auto (strips all client thinking fields), custom, adaptive |
customBudget | Fixed budget when mode=custom |
effortLevel | Base effort when mode=adaptive |
Not compression and not "decrypt encrypted reasoning". Full guide: docs/guides/THINKING_BUDGET.md.
Example — keep client-controlled reasoning (Codex/Desktop):
bash
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"}'Warning: mode=auto deletes reasoning / reasoning_effort / Claude thinking from the outbound body before upstream. That can empty thinking panels even when the client requested Ultra + summary. <!-- skill:custom-end -->
