ドキュメントを検索...

入力してドキュメントを検索

プラットフォームガイド

グループのピン留め

最安ルーティングの代わりに、モデルを特定のプロバイダーグループに固定します。

どのモデルも1つ以上のプロバイダーグループから提供され、それぞれに価格があります。既定ではキーは auto を使い、各リクエストは最も安く稼働中のグループへ送られます。

固定はモデルごとにこれを上書きします。使えるグループと試す順序を選べ、料金はそのレートに固定されます。

各モデルのページには、Group Pricing の下に入力と出力の価格が付いた全グループが載っています。モデル一覧の割引バッジは最も安いグループを反映します。

モデル詳細ページのグループ価格テーブル

APIキーでキーを作成または編集し、グループセレクタを開きます。モデルを検索してクリックし、グループを1つ以上選びます。触れなかったモデルは auto のままです。

キーエディター内のモデル別プロバイダグループ選択

ピン留めしたモデルは上位に並び、グループ数を示すバッジが付きます。Clear all でキーを auto に戻せます。キー一覧では、ピン留めしたキーが auto +N と表示されます。

レーンを一つずつ選ぶ代わりに、モデルの価格帯スライダー(つまみ2つ)をドラッグすると、その範囲に収まる料金のプロバイダーだけを経由します。名前ではなく価格で選ぶため、範囲に入る新しいプロバイダーは自動的に対象になります。

モデルの価格帯スライダーと、その範囲に入るレーン

価格範囲と固定したレーンは合算されます。範囲は安いプロバイダーをカバーし、固定は範囲外の特定の高いプロバイダーを予備として残します。安い順ではその予備はより安いものがすべて失敗したときにだけ使われ、自分で決めるではその位置を自分で決められます。

自動に戻すと、モデルは通常の安い順のチェーンで処理されます。価格帯とピンは保存されたまま無効になるため、自動を解除すれば以前の設定がそのまま復元されます。

自動をオンにした状態。保存された価格帯はグレー表示のまま保持されます

レーン一覧の下にあるフォールバックの順序で、選んだレーンを試す順序を決めます。既定は安い順で、レートの低いものから高いものへ並び、一覧はその順序を表示するだけで変更はできません。

フォールバックの順序が安い順の状態。選んだレーンがレート順に並んでいる

自分で決めるに切り替えると、選んだレーンをドラッグして好きな順に並べられます。リクエストはいちばん上のレーンから試し、失敗したときだけ下へ進むので、安いものより信頼できるプロバイダーを優先できます。価格順に並べるで安い順に戻せます。停止中のレーンは位置を保ったまま、復旧するまでスキップされます。

フォールバックの順序を自分で決めるにした状態。選んだレーンが番号付きの一覧とドラッグハンドルで表示されている

価格範囲を設定している場合、範囲によって追加されたが自分では選んでいないレーンは、一覧の後ろに安い順で続きます。あとから範囲に入ったプロバイダーもそこに入ります。

固定したモデルは固定したグループの中だけでルーティングされ、エラー時はフォールバックの順序で設定した順に切り替わります。リクエストを処理したグループのレートで課金されます。

ピン留めとウォッチを組み合わせると、グループの価格変動やダウンにすぐ気づけます。次を参照: 通知

キーを変えずに1回のリクエストだけ固定するには、正確なグループ名を入れた X-Group ヘッダーを送ります。キーのピン留めや auto ルーティングを上書きします。名前は Group Pricing からコピーしてください。

bash
curl https://api.test.wanmo.ai/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-relay-glm-5.2" \
  -d '{
    "model": "glm-5.2",
    "messages": [{ "role": "user", "content": "Hello" }]
  }'

ヘッダーには、そのキーが使えるグループを指定する必要があります。そうでなければリクエストは拒否されます。ピン留めしていないモデルは最安ルーティングのままです。

他のプロバイダーがそのモデルを提供中でも、ピン留めしたグループがすべて停止している場合、リクエストは汎用の混雑メッセージではなく専用のエラーで失敗します:

json
{
  "error": {
    "message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

ピン留めの範囲を広げるか解除するか、後で再試行してください。モデル自体は稼働しています。