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 を利用したアプリケーションのトレース、評価、監視、改善の反復を行えます。
モデルモデル ID (API 使用時)タイプコンテキストウィンドウパラメーター説明
DeepSeek R1-0528deepseek-ai/DeepSeek-R1-0528テキスト161K37B - 680B (アクティブ - 合計)複雑なコーディング、数学、構造化ドキュメント分析など、精度が求められる推論タスク向けに最適化されています。
DeepSeek V3-0324deepseek-ai/DeepSeek-V3-0324テキスト161K37B - 680B (アクティブ - 合計)高度に複雑な言語処理と包括的なドキュメント分析向けに調整された、堅牢な Mixture-of-Experts モデルです。
Llama 3.1 8Bmeta-llama/Llama-3.1-8B-Instructテキスト128K8B (合計)応答性の高い多言語チャットボットとのやり取り向けに最適化された、効率的な対話モデルです。
Llama 3.3 70Bmeta-llama/Llama-3.3-70B-Instructテキスト128K70B (合計)対話タスク、詳細な指示追従、コーディングに優れた多言語モデルです。
Llama 4 Scoutmeta-llama/Llama-4-Scout-17B-16E-Instructテキスト, ビジョン64K17B - 109B (アクティブ - 合計)テキストと画像の理解を統合したマルチモーダルモデルで、視覚タスクや複合的な分析に適しています。
Phi 4 Minimicrosoft/Phi-4-mini-instructテキスト128K3.8B (アクティブ - 合計)リソースが限られた環境で高速な応答を実現する、コンパクトで効率的なモデルです。
このガイドでは、次の情報を提供します。

前提条件

以下は、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 ライブラリをインストールしてください:
pip install openai weave
LLM アプリケーションのトレースに Weave を使用する場合にのみ、weave ライブラリが必要です。Weave の利用を開始する方法については、Weave クイックスタートを参照してください。Weave で W&B Inference サービスを使用する方法を示す API の使用例については、API の使用例を参照してください。

API 仕様

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

エンドポイント

Inference サービスには、以下のエンドポイントからアクセスできます。
https://api.inference.wandb.ai/v1
このエンドポイントにアクセスするには、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
curl https://api.inference.wandb.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "OpenAI-Project: <your-team>/<your-project>" \
  -d '{
    "model": "<model-id>",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "Tell me a joke." }
    ]
  }'

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

APIを使用して、現在利用可能なすべてのモデルとそのIDをクエリします。これは、モデルを動的に選択したり、環境で利用可能なモデルを確認したりするのに役立ちます。
curl https://api.inference.wandb.ai/v1/models \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "OpenAI-Project: <your-team>/<your-project>" \

使用例

このセクションでは、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 を完了している必要があります。
import weave
import openai

# トレース用のWeaveチームとプロジェクトを設定する
weave.init("<your-team>/<your-project>")

client = openai.OpenAI(
    base_url='https://api.inference.wandb.ai/v1',

    # https://wandb.ai/settings でAPIキーを作成する
    api_key="<your-api-key>",

    # W&B inferenceの使用状況トラッキングに必須
    project="wandb/inference-demo",
)

# WeaveでモデルのcallをトレースするWeave
@weave.op()
def run_chat():
    response = client.chat.completions.create(
        model="meta-llama/Llama-3.1-8B-Instruct",
        messages=[
            {"role": "system", "content": "You are a helpful assistant."},
            {"role": "user", "content": "Tell me a joke."}
        ],
    )
    return response.choices[0].message.content

# トレースされたcallを実行してログする
output = run_chat()
print(output)
コードサンプルを実行すると、ターミナルに出力されたリンク (例: 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 を使用するための追加の前提条件を満たしている必要があります。
import os
import asyncio
import openai
import weave
from weave.flow import leaderboard
from weave.trace.ref_util import get_ref

# トレース用のWeaveチームとプロジェクトを設定する
weave.init("<your-team>/<your-project>")

dataset = [
    {"input": "What is 2 + 2?", "target": "4"},
    {"input": "Name a primary color.", "target": "red"},
]

@weave.op
def exact_match(target: str, output: str) -> float:
    return float(target.strip().lower() == output.strip().lower())

class WBInferenceModel(weave.Model):
    model: str

    @weave.op
    def predict(self, prompt: str) -> str:
        client = openai.OpenAI(
            base_url="https://api.inference.wandb.ai/v1",
            # https://wandb.ai/settings でAPIキーを作成する
            api_key="<your-api-key>",
            # W&B inferenceの使用状況トラッキングに必須
            project="<your-team>/<your-project>",
        )
        resp = client.chat.completions.create(
            model=self.model,
            messages=[{"role": "user", "content": prompt}],
        )
        return resp.choices[0].message.content

llama = WBInferenceModel(model="meta-llama/Llama-3.1-8B-Instruct")
deepseek = WBInferenceModel(model="deepseek-ai/DeepSeek-V3-0324")

def preprocess_model_input(example):
    return {"prompt": example["input"]}

evaluation = weave.Evaluation(
    name="QA",
    dataset=dataset,
    scorers=[exact_match],
    preprocess_model_input=preprocess_model_input,
)

async def run_eval():
    await evaluation.evaluate(llama)
    await evaluation.evaluate(deepseek)

asyncio.run(run_eval())

spec = leaderboard.Leaderboard(
    name="Inference Leaderboard",
    description="Compare models on a QA dataset",
    columns=[
        leaderboard.LeaderboardColumn(
            evaluation_object_ref=get_ref(evaluation).uri(),
            scorer_name="exact_match",
            summary_metric_path="mean",
        )
    ],
)

weave.publish(spec)
次のコードサンプルを実行したら、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 エラー

Error CodeMessageCauseSolution
401無効な認証認証情報が無効であるか、W&Bのプロジェクト名およびentityが正しくありません。正しいAPIキーを使用していること、およびW&Bのプロジェクト名とentityが正しいことを確認してください。
403国、地域、または領域はサポートされていませんサポート対象外の地域からAPIにアクセスしています。Geographic restrictionsを参照してください
429リクエストの同時実行制限に達しました同時リクエストが多すぎます。同時リクエスト数を減らしてください。
429現在のクォータを超過しています。プランとbillingの詳細を確認してくださいクレジット不足、または月間支出上限に達しています。クレジットを追加購入するか、制限を引き上げてください。
500リクエストの処理中にサーバーエラーが発生しましたサーバー内部エラーです。少し待ってから再試行し、解消しない場合はサポートに連絡してください。
503推論エンジンは現在過負荷状態です。後でもう一度お試しくださいサーバーへのトラフィックが増加しています。少し待ってからリクエストを再試行してください。