グループのピン留め

各モデルは1つ以上のプロバイダグループで提供され、それぞれに価格があります。デフォルトのキーは auto を使い、リクエストは稼働中で最安のグループにルーティングされます。

ピン留めはこれをモデル単位で上書きします。使用できるグループを正確に選び、課金はそのレートに固定されます。特定プロバイダの品質やリージョン、変動しないレートが必要なときに便利です。

各モデルの詳細ページの Group Pricing に、グループごとの入力・出力価格が一覧表示されます。モデル一覧の割引バッジは常に最安グループを反映します。

APIキーを開き、キーを作成または編集してグループセレクターを開きます。モデルを検索してクリックし、レート倍率つきで最安順に並んだプロバイダグループを1つ以上チェックします。触らないモデルは auto のままです。

ピン留めしたモデルは、固定先グループ数を示すバッジつきで上部に浮上します。すべてクリアでキーは完全な auto に戻ります。キー一覧ではピン留めキーは auto +N と表示されます。

ピン留めされたモデルは、ピン留めしたグループの中だけでルーティングされます。最安から試し、エラーやダウン時は自動で次にフェイルオーバーします。実際にリクエストを処理したグループのレートが課金されます。

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

キーを変更せずにリクエストごとにピン留めすることもできます。正確なグループ名を指定した X-Group ヘッダーを送信してください。そのリクエストに限り、キーに保存されたピン留めや自動ルーティングより優先されます。モデルのグループ料金表から任意のグループ名をコピーできます。

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

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