モデルの検索

モデルページまたはモデルAPIを使用して、利用可能なテキストモデルを確認します。モデルのメタデータには、ベンダー、サービスプロバイダー、モダリティ、コンテキスト長、対応するAPIファミリー、対応する機能、可用性、アカウントレベルの制限、クレジット価格が含まれます。

エンドポイント: GET /v1/models 目的: 現在のアカウントで利用可能なモデルを一覧表示します。

コピーcurl --request GET \
  --url https://api.basicrouter.ai/api/v1/models \
  --header "Authorization: Bearer $BASICROUTER_API_KEY"

機能マトリックス

APIファミリー互換性マトリックス

認証

すべてのAPIリクエストはベアラートークンを使用します。キーはサーバー側の環境変数に保管し、 チームのアクセス権限に変更があった際はローテーションを行い、デバッグ用にリクエストIDを記録してください。

キーセキュリティの推奨事項

1. APIキーはサーバーに保管してください。ブラウザやモバイルのクライアントコードにキーを公開しないでください。
2. 開発、ステージング、本番、サードパーティ連携それぞれで別々のキーを 使用してください。
3. 利用可能な場合は、環境、サービス、顧客、またはテナントごとにキーのスコープを設定してください。
4. 従業員の退職、ベンダーアクセスの変更、または漏洩が疑われる場合は、 キーをローテーションしてください。
5. キーはソースコードではなく、シークレットマネージャーまたは環境変数に保管してください。

コンソールの使用

BasicRouterコンソールは、APIアクセス、モデル可用性、 ルーティングポリシー、使用量の可視化、請求管理のための運用管理平面です。 アカウント管理者に、キー、モデル、リクエスト、クレジット、 本番のモデルトラフィックに関するアカウントレベルのコントロールの 一元化されたビューを提供します。

APIキーの管理

コンソールからAPIキーの作成、ローテーション、失効、ラベル付けを行います。開発、ステージング、本番、 個別サービスそれぞれで別々のキーを使用し、使用量を環境やアプリケーションごとに 監査・分離できるようにしてください。

モデル一覧

モデル一覧ページを使用して、アカウントで利用可能なモデルを確認します。各モデルエントリには、 ベンダー、サービングプロバイダー、モダリティ、サポートされるAPIファミリー、コンテキスト長、 機能フラグ、可用性状態、価格情報が含まれる場合があります。

本番アプリケーションでは、トラフィックを有効化する前にモデルの機能を確認してください。 一部のパラメータや機能はモデルに依存し、すべてのAPIファミリーで サポートされるとは限りません。

使用量とログ

使用量とログビューは、APIトラフィックの運用可視性を提供します。チームは リクエスト量、選択されたモデル、解決されたルーティングターゲット、クレジット消費量、 レイテンシ、エラーコード、リクエストIDを調査できます。

• 失敗したリクエストのトラブルシューティング。
• 高コストのワークロードの特定。
• アプリケーションや環境間でのモデル使用量の比較。
• ルーティングとフォールバック動作の検証。
• レイテンシやプロバイダー可用性の問題の調査。
• サポートに連絡する際のリクエストIDの提供。

各APIレスポンスにはBasicRouterリクエストIDが含まれるか、公開されています。このIDを アプリケーションログに保存して、本番デバッグとサポートエスカレーションをより効率的にしてください。

フォールバック

フォールバックはBasicRouterのレジリエンスメカニズムです。プライマリモデルまたはルーティングポリシーが 失敗した場合、システムは自動的にバックアップモデルに切り替えてリクエストの処理を継続します。 これによりアプリケーションの応答性を維持し、サービス停止のリスクを最小限に抑えます。

フォールバックが重要な理由

本番環境では、モデルサービスは多くの予測不能な問題に遭遇する可能性があります：

• モデルサービスの障害：上流APIが一時的に 利用できなくなったりタイムアウトしたりします。
• パフォーマンスの変動：高いモデル負荷により、レスポンスが 遅くなったり失敗したりします。
• ルーティングの失敗：スマートルーティングで選択された すべての候補モデルが利用不可になります。

フォールバックは信頼性の高いバックアップパスを提供することで、アプリケーションの可用性を維持します。

主な利点

グローバルフォールバックモデル設定

BasicRouterはコンソールのバックエンドからグローバルフォールバックモデルの設定をサポートしています。 すべてのリクエストは失敗時にこのモデルをバックアップとして自動的に使用します。

設定方法：

1. BasicRouter戦略設定ページに 移動します。
2. デフォルトフォールバックモデル設定を見つけます。
3. ドロップダウンリストからグローバルフォールバックモデルを選択します。
4. 設定を保存して即座に適用します。

グローバル設定の利点：

• コード変更不要：一度設定すればグローバルに適用され、 すべてのリクエストで設定を繰り返す必要はありません。
• 一元管理：フォールバックポリシーを一箇所で管理し、 調整や監視を容易にします。
• メンテナンスの簡素化：コードの複雑さと設定エラーの 可能性を低減します。
• 柔軟な上書き：リクエストレベルのフォールバック設定が優先され、 特定のシナリオでグローバル設定を上書きできます。

リクエストレベルのフォールバック設定

特定のビジネスシナリオでは、個々のリクエストでフォールバックモデルを指定して、 グローバル設定を上書きできます。

router.fallBackModels パラメータでフォールバックモデルを指定します：

コピー{
  "model": "claude-sonnet-4",
  "messages": [
    {
      "role": "user",
      "content": "Explain what quantum computing is"
    }
  ],
  "router": {
    "fallBackModels": ["glm-5.2"]
  }
}

優先順位ルール

複数のフォールバック設定が存在する場合、優先順位は高から低へ 以下の順になります：

1. リクエストレベルの router.fallBackModels：個々のリクエストで指定されたフォールバックモデル。
2. グローバルデフォルトフォールバックモデル：コンソールで設定された グローバルフォールバックモデル。
3. フォールバックなし：いずれも設定されていない場合、リクエストは 失敗時にエラーを返します。

アカウント管理

アカウントの種類に応じて、コンソールにはアカウントレベルのモデル有効化、 リセラーまたはディストリビューターのコントロール、請求設定、アクセス設定が含まれる場合があります。 管理者はこれらのコントロールを使用して、モデルアクセス、使用量の可視性、 請求責任をアプリケーション、顧客アカウント、または事業単位に合わせることができます。

本番運用チェックリスト

請求とクレジット

BasicRouterは、テキスト、画像、動画、その他のサポートされるモデルワークロードにわたり クレジットベースの課金モデルを使用します。クレジットはマルチモデルおよびマルチプロバイダーの 使用量のための統一された単位を提供し、チームがモダリティやAPIファミリー全体で 消費量を一貫して管理できるようにします。

詳細なモデル価格は、モデル一覧ページまたはモデルメタデータAPIで確認できます。 価格は、モデル、プロバイダー、モダリティ、解像度、トークンタイプ、出力長、 タスク時間、アカウントタイプ、商取引契約によって異なる場合があります。

チャージとウォレット

アカウントは柔軟な使用のために従量課金ウォレットクレジットを追加できます。ウォレットクレジットは、 アカウントにカスタム請求ルールが適用されていない限り、月額プランのクレジットと リソースパックが消費された後に使用されます。

ウォレットクレジットは、適用される商取引条件で別途定められていない限り期限切れになりません。 従量課金ウォレットのチャージ時にサービス手数料が発生します。

月額プランとリソースパック

各ユーザーまたはアカウントは1つの有効な月額プランを選択できます。月額プランは、 請求期間中の定義された使用量、商取引条件、アカウントレベルのアクセス設定を提供します。

ユーザーは追加の使用量のために複数のリソースパックを購入することもできます。リソースパックは コミットされた使用量を従量課金ウォレット残高から分離でき、大容量のテキスト、画像、動画、 または専用ワークロードの使用に役立ちます。

課金順序

カスタム請求ルールが設定されていない限り、クレジットは以下の順序で 控除されます：

カスタム商取引条件を持つアカウントでは、控除順序、期限ルール、含まれる使用量、価格が 異なる場合があります。アカウント固有のルールはコンソールに表示されるか、 商取引契約を通じて提供されます。

カスタム価格

価格はユーザーまたはアカウントごとにカスタマイズできます。エンタープライズ顧客、リセラーアカウント、 ディストリビューターアカウント、大規模顧客はカスタム価格の対象となる場合があります。 見積もりについては営業にお問い合わせください。

カスタム価格は、アカウント、モデル、プロバイダー、モダリティ、リージョン、使用量、 または商取引契約ごとに設定できます。カスタム価格が有効な場合、コンソールと請求APIは 利用可能な範囲でアカウント固有の価格と控除ルールを反映します。

価格単位

異なるモデルモダリティは異なる測定単位を使用します。BasicRouterはモデルの価格ルールに 従ってこれらの単位をクレジットに変換します。

価格単位はモデルによって異なる場合があります。本番でモデルを有効にする前に、 必ずモデル詳細ページまたは価格メタデータを参照してください。

使用量の帰属

BasicRouterの使用量は、アカウント、APIキー、モデル、モダリティ、または時間範囲ごとに 確認できます。これによりチームはコストをアプリケーション、環境、顧客、 内部の事業単位に帰属させることができます。

クレジット残高

アカウント全体で利用可能なクレジット数を確認します。残高は順番に控除される3つの ウォレットに分割されます：月額プラン枠、購入済みリソースパック、従量課金ウォレット。 また、チャージ支出とは別に含まれる使用量を追跡するための、統合リソース合計 （月額プラン＋リソースパック、従量課金を除く）も利用可能です。

プログラムでこれを取得するには、APIリファレンスの GET /v1/billing/balanceを参照してください。

使用量の詳細

レポート、監視、内部コスト配分のための、個々の使用量レコードのページ分割された時系列リストを 確認します。各レコードはモデル、モデルタイプ（テキスト、画像、動画）、控除されたクレジット、 各控除がどのウォレットから引き出されたかの内訳を表示します。結果は特定の時間範囲で フィルターできます。

プログラムでこれを取得するには、APIリファレンスの GET /v1/usageを参照してください。

取引履歴

取引履歴を使用して、チャージ、プラン割り当て、リソースパック付与、使用量控除、調整、 管理上の修正を含むクレジットの動きを確認します。

プログラムでこれを取得するには、APIリファレンスの GET /v1/billing/transactionsを参照してください。

失敗したリクエストと返金

検証エラー、認証エラー、権限エラーは、モデルの実行が発生しないため通常は 課金されません。上流モデルに到達したリクエストや部分的な出力を生成したリクエストは、 モデル、プロバイダー、レスポンス状態に応じてクレジットを消費する場合があります。

非同期の画像および動画タスクの場合、課金動作はタスクが承認、開始、完了、失敗、 キャンセルされたかどうかに依存します。タスク詳細レスポンスには、クレジットが消費された 場合に使用量情報が含まれます。

チャージ、月額プラン、リソースパック、消費済みクレジットは、適用される商取引契約で 別途定められているか法律で要求されていない限り返金不可です。

運用

エラー

BasicRouterは安定したエラーコードを返すため、アプリケーションはリトライ、フォールバック、課金の問題、デバッグを一貫して処理できます。

プロバイダ互換エンドポイントは、可能な限り元のAPIファミリーのエラー構造を維持しようとします。BasicRouterネイティブエンドポイントはBasicRouterエラーオブジェクトを使用します。

HTTPステータスとエラーコードのマッピング

一般的なエラーコード