呼び出しチェーン設定

呼び出しチェーンとは

プラットフォームの 1 つのモデルは通常、複数のチャネルグループによって提供されます。グループごとに価格倍率と安定性が異なります。「呼び出しチェーン」とは、リクエストがこれらのグループ間で試行される順序です。チェーンの先頭にあるグループが優先的に使用され、失敗すると次のグループに自動的に移行します。

システムは各モデルに合理的なデフォルトチェーン(倍率の低い順)を生成します。大多数のユーザーにとってデフォルトで十分であり、設定しなくても正常に使用できます。

設定場所

API Key の作成・編集時に「呼び出しチェーン設定」エリアを展開してカスタマイズできます。これはオプションの高度な機能です。

設定できること

モデルごとに個別に設定:

  • 価格倍率範囲:許容する最小・最大倍率を設定。範囲外のグループは除外され、そのモデルの呼び出しに参加しません
  • グループ絞り込み:使用を許可するグループを選択。未選択のグループは呼び出されません
  • 並び替え:倍率昇順(デフォルト、最安値優先)、降順、または手動カスタム順

ページ右側にチェーンプレビューがあり、設定結果のグループ順序がリアルタイムで表示され、保存前に確認できます。

保存後の反映

チェーン設定は API Key に保存され、その Key で送信されるリクエストにのみ影響します。変更は新規リクエストに即座に反映され、Key の再生成は不要です。

使用のヒント

  • コスト制御や特定グループの除外が本当に必要な Key のみカスタムチェーンを有効にしてください
  • 範囲を狭くしすぎたりグループを少なくしすぎると、そのモデルで「利用可能なチャネルなし」エラーになる場合があります — エラー時はまずチェーン設定を確認してください
  • グループが変更された場合、プラットフォームがバックグラウンドで自動的にチェーンを同期更新します