Skip to main content

W&B Inference

W&B Inference は、W&B Weave と OpenAI 準拠 API を通じて、主要なオープンソース基盤モデルにアクセスできるようにする機能です。W&B Inference では、次のことができます。
  • ホスティングプロバイダーに登録したりモデルをセルフホストしたりすることなく、AI アプリケーションやエージェントを開発する。
  • W&B Weave Playground でサポート対象モデルを試す。
W&B Inference のクレジットは、期間限定で Free、Pro、Academic プランに含まれています。Enterprise での提供状況は異なる場合があります。クレジットを使い切ると、次のようになります。
  • Free アカウントは、Inference の使用を継続するために Pro プランへアップグレードする必要があります。
  • Pro プランのユーザーには、モデルごとの料金に基づき、Inference の超過分が毎月請求されます。
詳細は、料金ページW&B Inference のモデル料金 を参照してください。
Weave を使用すると、W&B Inference を利用したアプリケーションのトレース、評価、監視、改善の反復を行えます。 このガイドでは、次の情報を提供します。

前提条件

以下は、API または W&B Weave UI を介して W&B Inference サービスにアクセスするために必要な前提条件です。
  1. W&B アカウント。こちらからサインアップしてください。
  2. W&B APIキー。User Settings で APIキーを作成してください。
  3. W&B プロジェクト。
  4. Python 経由で Inference サービスを使用する場合は、Python 経由で API を使用するための追加の前提条件を参照してください。

Python 経由で API を使用するための追加の前提条件

Python 経由で Inference API を使用するには、まず一般的な前提条件を完了してください。次に、ローカル環境に openaiweave ライブラリをインストールしてください:
LLM アプリケーションのトレースに Weave を使用する場合にのみ、weave ライブラリが必要です。Weave の利用を開始する方法については、Weave クイックスタートを参照してください。Weave で W&B Inference サービスを使用する方法を示す API の使用例については、API の使用例を参照してください。

API 仕様

以下のセクションでは、API 仕様に関する情報と API の利用例を紹介します。

エンドポイント

Inference サービスには、以下のエンドポイントからアクセスできます。
このエンドポイントにアクセスするには、Inference サービスのクレジットが割り当てられた W&B アカウント、有効な W&B APIキー、そして W&B entity (「team」とも呼ばれます) およびプロジェクトが必要です。このガイドのコード例では、entity (team) とプロジェクトを <your-team>\<your-project> と表記しています。

利用可能な method

Inference サービスは、以下の API method をサポートします。

チャット補完

利用可能な主要な API method は /chat/completions です。これは、サポートされるモデルにメッセージを送信して補完を受け取るための OpenAI 互換の Request 形式をサポートします。Weave で W&B Inference サービスを使用する方法を示す使用例については、API usage examplesを参照してください。 チャット補完を作成するには、次が必要です。
  • Inference サービスのベース URL https://api.inference.wandb.ai/v1
  • W&B APIキー <your-api-key>
  • W&B entity 名とプロジェクト名 <your-team>/<your-project>
  • 使用するモデルの ID。以下のいずれかです。
    • meta-llama/Llama-3.1-8B-Instruct
    • deepseek-ai/DeepSeek-V3-0324
    • meta-llama/Llama-3.3-70B-Instruct
    • deepseek-ai/DeepSeek-R1-0528
    • meta-llama/Llama-4-Scout-17B-16E-Instruct
    • microsoft/Phi-4-mini-instruct

サポート対象モデルを一覧表示

APIを使用して、現在利用可能なすべてのモデルとそのIDをクエリします。これは、モデルを動的に選択したり、環境で利用可能なモデルを確認したりするのに役立ちます。

使用例

このセクションでは、Weave で W&B Inference を使用する方法を示す、いくつかの例を紹介します。

基本例: Weave で Llama 3.1 8B をトレースする

以下の Python コードサンプルは、W&B Inference API を使用して Llama 3.1 8B モデルにプロンプトを送信し、その呼び出しを Weave でトレースする方法を示しています。トレースを使用すると、LLM の呼び出しの完全な入出力を取得し、パフォーマンスを監視し、Weave UI で結果を分析できます。
Weave でのトレースの詳細をご覧ください。
この例では、次のことを行います。
  • OpenAI 互換クライアントを使用して chat completion リクエストを行う、@weave.op() でデコレートされた関数 run_chat を定義します。
  • トレースは記録され、W&B の entity とプロジェクト project="<your-team>/<your-project> に関連付けられます
  • この関数は Weave によって自動的にトレースされるため、その入力、出力、レイテンシー、メタデータ (モデル ID など) がログされます。
  • 結果はターミナルに出力され、トレースは指定したプロジェクト配下の https://wandb.aiTraces タブに表示されます。
この例を使用するには、General prerequisitesAdditional prerequisites for using the API via Python を完了している必要があります。
コードサンプルを実行すると、ターミナルに出力されたリンク (例: https://wandb.ai/<your-team>/<your-project>/r/call/01977f8f-839d-7dda-b0c2-27292ef0e04g) をクリックして、Weave でトレースを確認できます。あるいは、次の手順でも確認できます。
  1. https://wandb.ai にアクセスします。
  2. Traces タブを選択して、Weave のトレースを表示します。
次に、高度な例を試してください。
トレースの表示

高度な例: Inference サービス で Weave の評価とリーダーボードを使用する

Inference サービス で Weave を使用してモデル呼び出しをトレースするだけでなく、パフォーマンスを評価したり、リーダーボードを公開したりすることもできます。次の Python コードサンプルでは、シンプルな質問応答データセットで 2 つのモデルを比較します。 この例を使用するには、一般的な前提条件Python 経由で API を使用するための追加の前提条件を満たしている必要があります。
次のコードサンプルを実行したら、https://wandb.ai/ の W&B アカウントにアクセスし、次の操作を行ってください。
モデルの評価を表示
トレースを表示

UI

以下のセクションでは、W&B UI で Inference サービスを使用する方法を説明します。UI で Inference サービスにアクセスする前に、前提条件を満たしてください。

Inference サービスにアクセスする

Weave UI では、以下の場所から Inference サービスにアクセスできます。 https://wandb.ai/inference にアクセスします。

Inference タブから

  1. W&B アカウントにアクセスするには、https://wandb.ai/ を開きます。
  2. 左サイドバーから Inference を選択します。利用可能なモデルとその情報が表示されます。
Inference タブ

Playground タブから

  1. 左サイドバーで Playground を選択します。Playground のチャット UI が表示されます。
  2. LLM のドロップダウンリストで W&B Inference にマウスオーバーします。右側に、使用可能な W&B Inference モデルのドロップダウンが表示されます。
  3. W&B Inference モデルのドロップダウンから、次の操作を行えます。
Playground の Inference モデルのドロップダウン

Playground でモデルを試す

いずれかのアクセス方法でモデルを選択したら、Playground でそのモデルを試せます。利用可能な操作は次のとおりです。
Inference モデルを Playground で使用する

複数のモデルを比較する

Playground では、複数の Inference モデルを比較できます。Compare ビューには、次の 2 か所からアクセスできます。

Inference タブから Compare ビューにアクセスする

  1. 左サイドバーで Inference を選択します。利用可能なモデルとモデル情報が表示されたページが開きます。
  2. 比較するモデルを選択するには、モデルカード上の任意の場所 (モデル名を除く) をクリックします。選択されると、モデルカードの枠線が青色で強調表示されます。
  3. 比較したい各モデルについて、step 2 を繰り返します。
  4. 選択したいずれかのカードで、Compare N models in the Playground ボタンをクリックします (N は比較するモデル数です。たとえば、3 つのモデルを選択した場合、ボタンには Compare 3 models in the Playground と表示されます) 。比較ビューが開きます。
これで、Playground でモデルを比較し、Playground でモデルを試す で説明されている各機能を使用できます。
Playground で比較する複数のモデルを選択

Playground タブから Compare ビュー にアクセスする

  1. 左サイドバーで Playground を選択します。Playground のチャット UI が表示されます。
  2. LLM のドロップダウンリストで W&B Inference にマウスオーバーします。右側に、利用可能な W&B Inference モデルを含むドロップダウンが表示されます。
  3. ドロップダウンから Compare を選択します。Inference タブが表示されます。
  4. 比較するモデルを選択するには、モデルカード上の任意の場所 (モデル名を除く) をクリックします。選択されると、モデルカードの枠線が青色で強調表示されます。
  5. 比較する各モデルに対して step 4 を繰り返します。
  6. 選択したいずれかのカードで、Compare N models in the Playground ボタンをクリックします (N は比較するモデル数です。たとえば、3 つのモデルを選択している場合、ボタンには Compare 3 models in the Playground と表示されます) 。comparison view が開きます。
これで、Playground でモデルを比較し、Playground でモデルを試す で説明されている機能を使用できます。

請求と使用状況の情報を表示する

組織管理者は、現在の Inference クレジット残高、使用履歴、今後の請求額 (該当する場合) を W&B UI から直接確認できます。
  1. W&B UI で、W&B の Billing ページにアクセスします。
  2. 画面右下に Inference の請求情報カードが表示されます。ここでは、次のことができます。
  • Inference の請求情報カードにある View usage ボタンをクリックして、経時的な使用状況を確認します。
  • 有料プランをご利用の場合は、今後の Inference の請求額を確認します。
モデルごとの料金内訳については、Inference pricing pageを参照してください

利用に関する情報と制限

次のセクションでは、利用に関する重要な情報と制限について説明します。サービスを利用する前に、この情報をあらかじめ確認してください。

地理的制限

Inference サービスは、サポート対象の地域からのみ利用できます。詳細は、Terms of Serviceを参照してください。

同時実行制限

公平な利用と安定したパフォーマンスを確保するため、W&B Inference API では、ユーザー単位およびプロジェクト単位でレート制限を設けています。これらの制限には、次の目的があります。
  • 不正利用を防ぎ、API の安定性を保つ
  • すべてのユーザーが利用できるようにする
  • インフラストラクチャーの負荷を効果的に管理する
レート制限を超えると、API は 429 Concurrency limit reached for requests レスポンスを返します。このエラーを解消するには、同時リクエスト数を減らしてください。

料金

モデルの料金については、https://wandb.ai/site/pricing/inferenceを参照してください。

API エラー