OpenAI
このページは機械翻訳されています。元の英語の記事を表示

API プラットフォームでのプロジェクト管理

更新日: 14 days ago

プロジェクトは、お客様が作業を整理できるようにすることを目的としています。組織はアクセスと上限を管理し、サービスアカウントをプロビジョニングし(UI 経由)、プロジェクト内の限定されたスコープ(例: モデル、機能、スレッド、アシスタント、ファインチューニング、ストレージなど)に対する使用状況を追跡できます。使用状況はプロジェクトごとに分類でき、ユーザーは請求を確認したり、プロジェクトごとに予算を設定したりできます。

組織オーナーは、Projects page で、Active および Archived のすべてのプロジェクトを確認できます。API Platform におけるユーザーロールと権限の詳細をご覧ください。

Image

プロジェクトを作成できるのは誰ですか?

プロジェクトを作成できるのは組織オーナーのみです。詳細はロールと権限をご覧ください。

組織を切り替えるには、ページ左上の組織名にカーソルを合わせ、一覧から組織を選択します。

Projects page with the organization switcher open, listing Personal and Staging organizations

統合請求プランを利用している組織では、サブ組織は個別に識別されます。サブ組織内ではプロジェクトを作成できません。

Image

プロジェクトはどのように機能しますか?

すべての組織には、削除できない「デフォルトプロジェクト」が含まれます。レート制限、仮想モデルの権限、支出予算(2024 年 11 月時点)を設定できます。これは組織の完全な設定を継承するため、メンバーやサービスアカウントを直接追加することはできません。

プロジェクトを作成するにはどうすればよいですか?

まず、ページ左側のプロジェクト名にカーソルを合わせ、Create project を選択します。

API platform project menu with Create project highlighted under Default project

プロジェクトの名前、説明、Web サイトを入力し、Create を選択します。

Create a new project dialog in the API platform with fields for project name, use case, and business website

プロジェクトにユーザーを追加するにはどうすればよいですか?

新たに追加された組織メンバーは、自動的に「デフォルトプロジェクト」に追加されません。新しいメンバーは、組織に招待する際に("Invite to default project" チェックボックスを有効にして)プロジェクトに招待するか、メンバーが組織への招待を承諾した後に招待できます。

Admin API 経由で招待されたユーザーには、/organization/invites エンドポイントで説明されているルールが適用されます。

UI または Admin API を通じてプロジェクトにユーザーを招待する際にエラーが発生した場合は、招待を再送する前に、対象のプロジェクトが存在し、アーカイブされていないことをまず確認してください。

組織オーナーは、組織内で作成された新しいプロジェクトに自動的にオーナーとして追加されます。

組織とプロジェクトにはどのようなユーザーロールがあり、それぞれにどのような権限がありますか?

組織には「owner」と「reader」のロールがある一方で、プロジェクトには「owner」と「member」のロールがあります。プロジェクトメンバーは組織の reader に相当します。各ユーザーロールに付与される権限の詳細については、以下の表をご覧ください。

ロール範囲説明
Owner組織すべてのプロジェクト、すべてのユーザー、すべての API キーを作成・表示できます。Projects page を使って、組織内のすべてのプロジェクトを横断して監視できます。組織予算とプロジェクト予算を設定できます。組織内の他のユーザーに使用状況情報の閲覧権限を付与できます。プロジェクトをアーカイブできます。
Reader組織所属プロジェクトで推論の実行、リソースの使用、キーの作成ができます。プロジェクトに追加できます。ユーザー管理やプロジェクト作成はできません。
Ownerプロジェクト他のユーザーをプロジェクトに追加したり、プロジェクト名を変更したりでき、さらに Member のすべての権限を持ちます。プロジェクト予算を設定できます。プロジェクトをアーカイブできます。
Memberプロジェクトプロジェクトレベルで推論の実行、リソースの使用、キーの作成ができます。

組織で Owner ではない場合、何にアクセスできますか?

組織で Owner ではないユーザーは、自分がメンバーであるプロジェクトのみ表示できます。すべてのプロジェクト、メンバー、プロジェクトレベルの API キーを表示でき、Projects page にアクセスできるのは組織オーナーのみです。

  • プロジェクト内で作成されたファインチューニング済みモデル、作成された Assistants のスレッド、追加されたファイルを表示できるのは、そのプロジェクトのメンバー(および組織オーナー)のみです。

  • プロジェクトのメンバーは、そのプロジェクトの他のすべてのメンバーとそのロール(Owner または Member)を確認できます。

ユーザーのプロジェクトロールを更新したり、プロジェクトからユーザーを削除したりするにはどうすればよいですか?

ユーザーのプロジェクトロールを更新したり、プロジェクトからユーザーを削除したりできるのは、プロジェクトの Owner のみです。詳細はロールと権限をご覧ください。

プロジェクト内のユーザーを更新するには、組織設定に移動し、プロジェクトを選択して、Members をクリックします。各メンバーのロールを Member または Owner. に設定できます。また、Remove を選択してユーザーをプロジェクトから削除することもできます。

サービスアカウントとは何ですか?通常のユーザーアカウントとの違いは何ですか?

サービスアカウントは、個々のユーザーアカウントとは異なる、システムアクセス用に設計された擬似ユーザーとして機能します。サービスアカウントを作成できるのは、組織オーナーとプロジェクトオーナーのみです。

サービスアカウントはプロジェクトにのみスコープされます。

プロジェクトにメンバーを追加する

+ Add member ボタンをクリックすると、組織内で Reader ロールを持つユーザーの一覧が表示されます。現在組織に属していないユーザーを追加したい場合は、まずそのユーザーを組織に追加する必要があります(これらのユーザーにより広いアクセス権を与えたくない場合は、'Add to Default Project" チェックボックスをオフのままにできます)。この一覧にはサービスアカウントは含まれません。この手順では、ロールを Owner または Member から選択できます。

Project members with Add team members dialog assigning a user the Member role

チームメンバーを追加する際は、Member または Owner ロールのいずれかを割り当てる必要があります。プロジェクトメンバーはデータの読み取りや変更を行う API リクエストを実行でき、プロジェクトオーナーはそれに加えて、プロジェクト設定やプロジェクト予算の変更、プロジェクトメンバーの管理も行えます。詳細はロールと権限をご覧ください。

プロジェクト用のサービスアカウントを作成する方法

まず、ナビゲーションバーのドロップダウンから、サービスアカウントを作成したいプロジェクトに移動します。

API platform project switcher open with options to create a project or manage projects

次に、組織設定 -> Project -> Members -> + Service account をクリックします。

プロジェクトレベルで作成されたサービスアカウントはそのプロジェクト専用であり、作成されたプロジェクトの外では使用できません。

Project Members page with Create a service account dialog after selecting the Service account option

サービスアカウントの命名

サービスアカウントを組織レベルで作成する場合でも、プロジェクト専用のものを作成する場合でも、サービスアカウントを作成する際に、英字、数字、ハイフンで構成される一意のサービスアカウント ID を作成して、サービスアカウントを簡単に識別できます。

サービスアカウント API キーの保存

Create ボタンを選択すると、サービスアカウント用の API キーが即座に作成され、シークレットキーが表示されます。このシークレットキーは安全な場所に保存してください。セキュリティ上の理由から、OpenAI アカウントでは再度表示できません。このシークレットキーを紛失した場合は、新しいものを生成する必要があります。

Members page with Save your key modal after creating a service account

サービスアカウント API キーの権限は、デフォルトでプロジェクトのすべての API リソースに対する読み取りおよび書き込みに設定されています。これらの権限は、プロジェクトの API Keys 設定で更新できます。

サービスアカウントは、プロジェクトのメンバー設定ページでプロジェクトメンバーと並んで表示されます。プロジェクトのメンバー設定ページでサービスアカウントのアクセスを更新または削除する方法の詳細は、こちらをご覧ください。

プロジェクトと組織の両方にまたがるすべてのサービスアカウントは、組織レベルのメンバーページで通常のユーザーと並んで表示されます。

サービスアカウントは通常のアカウントと同様に管理されます。Organization -> Members メニューから、サービスアカウントの Remove やロールの更新を行えます。

OpenAI API Members settings with a service account role menu open for Reader or Owner

組織のプロジェクト内で API キーを管理するにはどうすればよいですか?

各プロジェクトの設定ページで、そのプロジェクト用の API キーを作成・管理できます。組織設定でプロジェクトを選択し、API Keys をクリックします。

新しいシークレットキーを作成するには、+ Create new secret key を選択します。シークレットキーの横にある編集アイコンを選択して、その権限を編集することもできます。

API keys page for a project with the Create new secret key button highlighted

新しいシークレットキーを作成するとき、または既存のキーを編集するときに、各 API キーの権限を設定できます。

権限レベルは 3 種類あります。All、Restricted、Read Only です。

  • All — シークレットキーにフル権限が設定されます。これがデフォルト設定です。

  • Restricted — 各エンドポイントに対して None、Read、Write の権限を設定できます。

    • たとえば、/v1/assistants エンドポイントに対して Read または Write の権限を持たない API キーを作成できます。

      Create new secret key dialog in the API platform with Restricted permissions selected
  • Read Only — すべてのエンドポイントに対して Read 権限が設定されます。

複数のプロジェクトまたは組織に所属するユーザーのアクセスはどのように管理されますか?

ユーザーは必要な数だけプロジェクトのメンバーになれます。プロジェクト内では、そのプロジェクトとそのリソースへのアクセスに限定された個人用 API キーを生成できます。

組織のプロジェクトのレート制限を設定・管理するにはどうすればよいですか?

プロジェクトレベルのレート制限を設定・管理できるのは、組織の Owner のみです。詳細はロールと権限をご覧ください。


組織設定で、更新したいプロジェクトをクリックし、ナビゲーションリストの Project セクションで Limits を選択.します。このページで Model Usage を更新できます。

Model usage では、プロジェクトで使用できるモデルを設定でき、必要に応じて各モデルにrate limits を設定できます。

組織のプロジェクトの予算を設定・管理するにはどうすればよいですか?

プロジェクト予算を設定・管理できるのは、組織の Owner とプロジェクトの Owner のみです。詳細はロールと権限をご覧ください。組織レベルの上限を変更するには、組織設定Limits, をクリックし、Usage limits. までスクロールします。

Project Limits page with organization budget controls, usage alerts, and model rate limits table

プロジェクトの上限を設定するには、組織設定で更新したいプロジェクトをクリックし、Limits. を選択します。Monthly budgetNotification threshold、および Model Usage を更新できます。


monthly budget を設定すると、プロジェクトに対してソフトな支出しきい値を設定できます。特定の暦月(UTC)内で使用量がこの上限を超えても、API リクエストは中断されることなく引き続き処理されます。この機能は予算アラートを通じて使用状況を監視しやすくするためのものであり、支出のハードキャップを強制するものではありません。プロジェクト予算を作成すると、デフォルトで 100% のしきい値にアラートが作成されます。別のしきい値で追加の予算を設定するには、Add Alert をクリックします。

組織オーナーとプロジェクトオーナーは、これらのメッセージを常に受信します。これはカスタマイズできません。

Project Limits page with Add budget alert dialog set to notify at 90% budget usage

プロジェクトを削除またはアーカイブするにはどうすればよいですか?

プロジェクトは、新しいプロジェクト一覧ページ、または各プロジェクトの設定からアーカイブできます。一度アーカイブしたプロジェクトは復元できません。アーカイブを進める際には、続行するためにプロジェクト名の入力を求められます。

アーカイブ済みプロジェクトの一覧は、同じプロジェクト一覧ページの「Archived」タブで確認できます。

API platform Projects page with the Archived tab selected to view archived projects

プロジェクトの削除はできません。使用状況と請求の追跡の継続性を確保するため、すべてのプロジェクトの履歴を保持しています。

組織内で持てるプロジェクト数に上限はありますか?

組織ではデフォルトで最大 2,000 件のプロジェクトを作成できます。

リソースはプロジェクト間で共有できますか?

プロジェクトのリソース(ファイル、アシスタント、ストレージ、スレッドなど)はそのプロジェクトにスコープされており、プロジェクト外の非管理メンバーからはアクセスできません。さらに、リソースをプロジェクト間で移動することもできません。

唯一の例外として、「デフォルトプロジェクト」のファインチューニングは他のプロジェクトからアクセスできます。

プロジェクトごとのファイルストレージ上限はどれくらいですか?

OpenAI は現在、プロジェクトごとに 100 GB のファイルストレージ上限をサポートしています。

この上限を超えると、次のエラーが表示されます。

ファイルストレージの上限を超過しました。組織ではファイルは 100 GB までに制限されています。ファイルサイズを減らすか、サポートにお問い合わせください。

アカウントに保存されている未使用のファイルを削除することをお勧めします。参考として、API を使ってファイルの表示と一覧取得ができます。

プロジェクトオーナーなのに、なぜプロジェクトの Usage Dashboard が表示されないのですか?

プロジェクトの Usage Dashboard の表示可否は、プロジェクト内でのユーザーのロールとは関係ありません。代わりに、組織内でのあなたのロール https://platform.openai.com/settings/organization/data-controls/visibility の設定によって決まります。

Project setting for Usage dashboard visibility with Visible to organization owners selected

Usage Dashboard が表示されない場合、この設定はおそらく "Visible to organization owners" に設定されています。

この記事は役に立ちましたか?