사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-settings시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
<!-- 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 -->
