Service API の概要

Weave Service API を使用すると、Weave の機能にプログラムからアクセスするための REST エンドポイントを利用できます。

​

ベースURL

W&B Multi-tenant Cloud および W&B 専用クラウド では、次のベースURLを使用します。

https://trace.wandb.ai

W&B セルフマネージドインスタンス の場合は、以下を使用します：

https://<your-subdomain>.wandb.io/traces

​

認証

リクエストヘッダーに W&B APIキーを含めます。

curl -H "Authorization: Bearer YOUR_API_KEY" https://trace.wandb.ai/...

​

利用可能なエンドポイント

​

Call

• POST /call/end - コール終了
• POST /call/read - コール読み取り
• POST /call/start - コール開始
• POST /call/update - コール更新
• POST /call/upsert_batch - コール一括開始
• POST /calls/delete - Call削除
• POST /calls/query_stats - Callクエリ統計
• POST /calls/stats - コール統計
• POST /calls/stream_query - Callクエリストリーム
• POST /calls/usage - Call使用状況
• POST /trace/usage - トレース使用状況

​

コスト

• POST /cost/create - コストの作成
• POST /cost/purge - コストのパージ
• POST /cost/query - コストのクエリ

​

フィードバック

• POST /feedback/batch/create - フィードバックのバッチ作成
• POST /feedback/create - フィードバックの作成
• POST /feedback/payload_schema - フィードバックのペイロードスキーマ
• POST /feedback/purge - フィードバックのパージ
• POST /feedback/query - フィードバックのクエリ
• POST /feedback/replace - フィードバックの置換
• POST /feedback/stats - フィードバックの統計

​

ファイル

• POST /file/content - ファイル内容
• POST /file/create - ファイル作成
• POST /files/query_stats - ファイルの統計

​

オブジェクト

• GET /aliases - エイリアス一覧
• POST /obj/create - Obj の作成
• POST /obj/delete - Obj の削除
• POST /obj/read - Obj の読み取り
• POST /objs/query - Objs のクエリ
• PUT /objs/{object_id}/aliases - Obj のエイリアス設定
• POST /objs/{object_id}/aliases/remove - Obj からエイリアスを削除
• PUT /objs/{object_id}/versions/{digest}/tags - Obj にタグを追加
• POST /objs/{object_id}/versions/{digest}/tags/remove - Obj からタグを削除
• GET /tags - タグ一覧

​

OpenTelemetry

• POST /otel/v1/traces - トレースのエクスポート

​

Refs

• POST /refs/read_batch - Refs の一括読み取り

​

サービス

• GET /geolocate - 呼び出し元の位置情報を取得
• GET /health - ルート情報を取得
• GET /server_info - サーバー情報
• POST /service/projects_info - Projects 情報
• GET /version - バージョン情報を取得

​

Tables

• POST /table/create - 表の作成
• POST /table/create_from_digests - ダイジェストから表を作成
• POST /table/query - 表をクエリする
• POST /table/query_stats - 表クエリの統計
• POST /table/query_stats_batch - 表クエリ統計のバッチ
• POST /table/update - 表の更新
• POST /table/query_stream - 表クエリのストリーム

​

スレッド

• POST /threads/stream_query - スレッドのクエリストリーム

​

Inference

• GET /inference/analysis/artificialanalysis/models - Inference Analysis Artificialanalysis モデル
• GET /inference/nvidia/v2/hardware - NVIDIA ハードウェア
• GET /inference/router/openrouter/models - Inference Router OpenRouter モデル

​

アノテーションキュー

• POST /annotation_queues - アノテーションキューの作成
• POST /annotation_queues/query - アノテーションキューのクエリストリーム
• POST /annotation_queues/stats - アノテーションキューの統計情報
• DELETE /annotation_queues/{queue_id} - アノテーションキューの削除
• GET /annotation_queues/{queue_id} - アノテーションキューの取得
• PUT /annotation_queues/{queue_id} - アノテーションキューの更新
• POST /annotation_queues/{queue_id}/items - アノテーションキューへのCallの追加
• POST /annotation_queues/{queue_id}/items/query - アノテーションキュー項目のクエリ
• POST /annotation_queues/{queue_id}/items/{item_id}/progress - アノテーションキュー項目の進捗更新

​

評価

• POST /evaluations/evaluate_model - モデルを評価
• POST /evaluations/status - 評価ステータス
• GET /v2/{entity}/{project}/evaluations - 評価一覧
• POST /v2/{entity}/{project}/evaluations - 評価を作成
• DELETE /v2/{entity}/{project}/evaluations/{object_id} - 評価を削除
• GET /v2/{entity}/{project}/evaluations/{object_id}/versions/{digest} - 評価を取得

​

スコア

• POST /calls/score - Call スコア
• DELETE /v2/{entity}/{project}/scores - スコアの削除
• GET /v2/{entity}/{project}/scores - スコア一覧
• POST /v2/{entity}/{project}/scores - スコアの作成
• GET /v2/{entity}/{project}/scores/{score_id} - スコアの取得

​

画像

• POST /image/create - 画像作成

​

Registry

• POST /link_to_registry - Registry へのリンク

​

Ops

• GET /v2/{entity}/{project}/ops - Op 一覧
• POST /v2/{entity}/{project}/ops - Op 作成
• DELETE /v2/{entity}/{project}/ops/{object_id} - Op 削除
• GET /v2/{entity}/{project}/ops/{object_id}/versions/{digest} - Op 取得

​

Datasets

• GET /v2/{entity}/{project}/datasets - データセット一覧
• POST /v2/{entity}/{project}/datasets - データセット作成
• DELETE /v2/{entity}/{project}/datasets/{object_id} - データセット削除
• GET /v2/{entity}/{project}/datasets/{object_id}/versions/{digest} - データセット取得

​

Scorers

• GET /v2/{entity}/{project}/scorers - Scorer 一覧取得
• POST /v2/{entity}/{project}/scorers - Scorer 作成
• DELETE /v2/{entity}/{project}/scorers/{object_id} - Scorer 削除
• GET /v2/{entity}/{project}/scorers/{object_id}/versions/{digest} - Scorer 取得

​

モデル

• GET /v2/{entity}/{project}/models - モデル一覧
• POST /v2/{entity}/{project}/models - モデル作成
• DELETE /v2/{entity}/{project}/models/{object_id} - モデル削除
• GET /v2/{entity}/{project}/models/{object_id}/versions/{digest} - モデル取得

​

評価 Runs

• DELETE /v2/{entity}/{project}/evaluation_runs - 評価 run の削除
• GET /v2/{entity}/{project}/evaluation_runs - 評価 run の一覧取得
• POST /v2/{entity}/{project}/evaluation_runs - 評価 run の作成
• GET /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id} - 評価 run の取得
• POST /v2/{entity}/{project}/evaluation_runs/{evaluation_run_id}/finish - 評価 run の終了

​

予測

• DELETE /v2/{entity}/{project}/predictions - 予測の削除
• GET /v2/{entity}/{project}/predictions - 予測の一覧取得
• POST /v2/{entity}/{project}/predictions - 予測の作成
• GET /v2/{entity}/{project}/predictions/{prediction_id} - 予測の取得
• POST /v2/{entity}/{project}/predictions/{prediction_id}/finish - 予測の完了

​

評価結果

• POST /v2/{entity}/{project}/eval_results/query - 評価結果クエリ