認証と entity

Forge API キーを HTTP Bearer token として送信します：

Authorization: Bearer <wandb-api-key>

サービスは、すべての管理リクエストで Weights & Biases viewer、デフォルトの entity、およびチームのメンバーシップを解決します。プロキシは、キーのハッシュによって同じアイデンティティをキャッシュします。

Management entity の選択

entity ヘッダーを省略すると、キーのデフォルトの entity が使用されます。ただし、GET /projects と GET /projects/summaries は例外で、ヘッダーを省略した場合は、キーがアクセスできるすべての entity の project が一覧表示されます。次のリクエストは、アクセス可能なすべての entity の project を一覧表示します：

curl https://forge.coreweave.com/api/distillation/v1/projects \
  -H "Authorization: Bearer $WANDB_API_KEY"

1 つのヘッダーでアクセス可能なチームを選択します：

curl https://forge.coreweave.com/api/distillation/v1/projects \
  -H "Authorization: Bearer $WANDB_API_KEY" \
  -H "Forge-Entity: your-team"

entity のクエリパラメーターは拒否されます。これにより、リソースフィルターが所有権と混同されるのを防ぎます。

プロキシでの entity の選択

プロキシリクエストでは、OpenAI-Project: <entity>/<project> ヘッダーで entity と project をまとめて指定します。<project> には、その project の Weights & Biases 上のプロジェクト名を指定します。OpenAI SDK は project クライアントオプションまたは OPENAI_PROJECT_ID 環境変数の値をもとにこのヘッダーを送信するため、カスタムヘッダーを設定する必要はありません。

import os

from openai import OpenAI

client = OpenAI(
    base_url="https://proxy.training.coreweave.com/v1",
    api_key=os.environ["WANDB_API_KEY"],
    project="your-team/ticket-classifier",  # OpenAI-Project ヘッダーとして送信されます
)

ヘッダーで entity を指定するため、個人用 APIキーでもデフォルトの entity を変更せずにチームの project を呼び出せます。プロキシは project を検索する前に、そのキーが entity にアクセスできるかどうかを確認します。キーが entity にアクセスできない場合、プロキシは 403 を返します。 <entity>/<project> 形式ではない値を指定すると、400 が返されます。たとえば、OPENAI_PROJECT_ID に残ったままになっていることが多い proj_abc123 のような OpenAI のプロジェクト ID を指定すると、400 が返され、この変数の設定を解除または変更するよう促すヒントが表示されます。

本番用の認証情報

デプロイ済みのアプリケーションや長時間実行するジョブには、Weights & Biases チームのサービスアカウントキーを優先して使用してください。個人の認証情報では、可用性が特定の従業員のアクセス権に依存し、デフォルトでその従業員の個人 entity が使用されます。

Model Distillation

Serverless Training

Management entity の選択

プロキシでの entity の選択

本番用の認証情報

​Management entity の選択

​プロキシでの entity の選択

​本番用の認証情報

Management entity の選択

プロキシでの entity の選択

本番用の認証情報