プロバイダーポリシーリファレンス

推論リクエストで実行プロバイダーを選択する際に、ShareAIプロバイダーのフィールド、デフォルト、制限、およびエラーを参照してください。

このページについて

オプションの provider オブジェクトは、推論リクエストのトップレベルに属し、 model. と並列します。空のオブジェクトはデフォルトを使用します。これは、プロバイダーリモートアクセスおよびその管理資格情報とは別です。

フィールド	タイプ	挙動
`only`	プロバイダータグの配列	実行をこれらのプロバイダーに制限する。
`ignore`	プロバイダータグの配列	フォールバックを含む、これらのプロバイダーを除外する。
`order`	プロバイダータグの配列	提供された順序でこれらのプロバイダーを優先的にランク付けし、その後ソートを適用する。
`allow_fallbacks`	ブール値; デフォルトはtrue	他の適格なプロバイダーを許可する。falseと非空の順序リストがある場合、リストされたプロバイダーのみが残ります。順序がない場合、最初にランク付けされたプロバイダーのみが残ります。
`networks`	配列	プロバイダータイプをコミュニティ、企業、および/またはshareaiに制限する。
`sort`	文字列またはオブジェクト	価格、レイテンシー、スループット、またはbyとdirectionを含むオブジェクトを使用する。

JSON

{
  "provider": {
    "ignore": [
      "PROVIDER_TO_EXCLUDE"
    ],
    "networks": [
      "company",
      "shareai"
    ],
    "sort": {
      "by": "throughput",
      "direction": "desc"
    },
    "allow_fallbacks": true
  }
}

プレースホルダーを実際の小文字のプロバイダータグに置き換えるか、ignoreフィールドを削除してください。ネットワークタイプはインフラストラクチャカテゴリを選択しますが、モデルクリエイターを特定するものではありません。

ソートのデフォルト#

並べ替え	デフォルトの方向	明示的な逆順
`price`	`asc` — 最低値が最初	`desc` — 最高値が最初
`latency`	`asc` — 最短経過時間が最初	`desc` — 最長が最初
`throughput`	`desc` — 秒あたりの出力トークン数が最も多いものが最初	`asc` — 最も少ないものが最初

オブジェクトの場合、 by これらの名前のいずれかに設定し、 direction から asc または desc. 。参照測定方法とフォールバックの動作について.

検証とエラー#

JSONのブール値と小文字のプロバイダータグの配列を使用してください。プロバイダーまたはソートにnullを送信しないでください。
リストされたフィールドのみが受け入れられます。これはOpenRouterパラメータの完全な実装ではありません。
ポリシーは8 KiBに制限されています。only、ignore、orderリストはそれぞれ最大100タグを受け入れます。
無効なポリシーはHTTP 400を返します。禁止された資格情報スコープはHTTP 403を返します。適格な利用可能なプロバイダーがない場合はHTTP 503を返します。

最小限のポリシー#

JSON

{
  "provider": {
    "sort": "price"
  }
}

完全に省略された場合、プロバイダー選択は決定論的な価格昇順ランキングにもデフォルト設定されます。制約は常にランキングの前に適用されます。

最終更新日 2026年9月16日