omni-settings について
omni-settings は、OmniRoute の全般設定を読み書きする認証付き API エンドポイントを提供します。プロンプトや推論予算から、プロキシ、データベース、機能フラグまで扱います。
主な機能
- 01全般設定の読み取りと更新
- 02システムプロンプトと推論予算の設定
- 03プロキシと IP フィルターの管理
- 04データベース設定の確認と変更
- 05設定のエクスポートとインポート
活用シーン
- 01API 経由でアプリ設定を変更
- 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/Desktop):
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 を要求していても、思考パネルが空になることがあります。