グループのピン留め

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

ピン留めはこれをモデルごとに上書きします。使えるグループを自分で選び、課金はその料金に固定されます。

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

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

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

ピン留めしたモデルは、ピン留めしたグループ内でのみ安い順にルーティングされ、エラー時はフェイルオーバーします。実際に処理したグループの料金で課金されます。

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

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

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

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

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

{
  "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"
  }
}

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