OpenRouter、LLMの設定を一元管理する新機能「Presets」を発表 ダッシュボード変更で全アプリに即時反映
要点
-
OpenRouterは、モデルやシステムプロンプト、各種パラメータの設定をコードから切り離して一元管理できる新機能「Presets」を発表した。
-
プリセットには単一モデルまたは優先順のフォールバック配列、プロバイダールーティング、サンプリング設定、各種ツールを登録できる。
-
APIリクエスト側でプリセット名を指定するだけで利用でき、ダッシュボード上で設定を更新すれば再デプロイなしで全アプリに即時反映される。
-
各APIリクエストによる個別パラメータの上書き(オーバーライド)や、API経由でのプリセット作成にも対応している。
-
2026年9月10日、AIモデルのルーティングプラットフォームを提供するOpenRouterは、大規模言語モデル(LLM)呼び出しに関する設定を一元管理できる新機能「Presets(プリセット)」に関するガイドを公開した。本機能は、アプリケーションコード内に分散しがちなモデル設定をダッシュボード上で名前付きの設定セットとして管理し、コード側から名前で参照できるようにするものだ。
コード修正・再デプロイを不要にする設定管理のアプローチ
Webアプリケーションやバッチ処理スクリプト、実験用ノートブックなど複数の環境でLLMを利用する場合、モデル名やシステムプロンプト、温度パラメータ(生成の多様性を制御する指標)を各コードベースに個別に記述するのが一般的だった。しかしこの方法では、モデルやパラメータを微調整するたびにすべてのコードを書き換えて再デプロイする必要が生じる。
OpenRouterが提供を開始したPresetsは、こうした課題を解決するための機能である。同社はこれを「LLM呼び出しのためのConfig-as-Code(コードとしての設定管理)」と位置づけている。環境変数(.env)ファイルや構成管理ツールのモジュールのように設定をアプリケーションロジックの外部へ切り出し、名前(スラッグ:識別用の文字列)で参照する仕組みだ。環境変数ファイルとは異なり、設定実体はOpenRouterのダッシュボード上に保存されるため、ダッシュボード上でプリセットを更新するだけで、そのプリセットを参照しているすべてのアプリケーションの挙動が即座に切り替わる。これにより、コード変更権限を持たない担当者でもダッシュボードへのアクセス権があれば設定の調整が可能になる。
登録可能な設定項目と柔軟なフォールバック機能
単一のプリセットには、LLM呼び出しに必要な以下の要素を包括して登録できる。
- モデル選択: 単一モデルの指定だけでなく、優先順位をつけたフォールバック(障害や制限発生時に代替モデルへ切り替える仕組み)用のモデル配列を設定可能。プライマリモデルがレート制限やサービス障害、コンテキスト長の上限超過などで失敗した場合、登録された順序に従って自動的に次のモデルが試行される。
- プロバイダールーティング: 各モデルを提供するプロバイダーについて、価格順やレイテンシ(応答遅延)順によるソートを指定できるほか、特定のプロバイダーを除外する設定が行える。
- システムプロンプト: すべてのリクエストの先頭に自動で付加される共通の指示文を保持する。
- サンプリングパラメータ: Temperature(出力のランダム性)やTop P(確率分布の上位サンプリング範囲)など、モデルの挙動を決定する既定値を定義する。
- ツール群: Web検索、画像生成、アドバイザー、サブエージェントといったOpenRouterが提供する各種サーバーツールの利用設定を含めることができる。
設定はWebダッシュボード上の専用エディター(openrouter.ai/settings/presets)からGUIで作成でき、任意のスラッグを割り当てて保存する。
API呼び出しの記述方法と柔軟なオーバーライド仕様
作成したプリセットは、APIリクエストのモデル指定部分にプレフィックスを付けた形式("model": "@preset/プリセット名")で記述して呼び出す。従来の呼び出しではプロバイダー設定や温度、システムプロンプトを個別に指定していたが、プリセットを利用することでリクエスト本文をユーザー入力などの最小限のデータのみに簡素化できる。
また、API経由で直接プリセットを作成することも可能だ。専用のエンドポイント(https://openrouter.ai/api/v1/presets/<slug>/chat/completions)に対してPOSTリクエストを送信すると、モデルやプロンプトなどの設定項目のみが保存され、リクエストに含まれるプロンプト本文やストリーミングフラグといった一時的なフィールドは自動的に除外される。
プリセット利用時でも、個別リクエストごとにパラメータを上書き(オーバーライド)することが可能となっている。マージ処理はシャローマージ(最上位のキー単位での上書き)で行われ、リクエスト側に含まれるパラメータがプリセット側の同名設定より優先される。ただし「tools」のみ例外的なマージルールが適用され、プリセット側のツール一覧とリクエスト側のツール一覧が結合された上で、同一名称のツールがある場合のみリクエスト側のツールで置き換えられる仕様となっている。
なお、API呼び出しにおける指定方法としては、独立したフィールド("preset": "@preset/プリセット名")を使用する形式や、モデル名と結合した形式("model": "モデル名@preset/プリセット名")もサポートされている。いずれの場合も@preset/のプレフィックスが必須であり、プレフィックスのない文字列のみを指定した場合は無視される。
バージョン管理とデフォルト設定の挙動
Presetsはバージョン管理に対応しており、既存のスラッグに対して設定を更新・保存すると新しいバージョンが自動生成されてアクティブ状態となる。
API全体に適用される単一のグローバルなデフォルトプリセットという概念は存在せず、APIリクエスト側で必ず対象のプリセット名を指定する必要がある。一方、OpenRouterのWebチャット機能(Chatroom)においては、設定画面(Settings > Preferences)内に新規メッセージへ適用するDefault Preset設定が用意されている。
OpenRouterは、標準的な応答形式や短い回答を求めるルールなど、共通の基本挙動をプリセットとして定義して組織内の各サービスで参照することを推奨している。共通設定を一元管理しつつ必要に応じて個別リクエストで上書きする構成をとることで、複数アプリケーションにわたるLLM設定の一貫性と保守性を高められるとしている。