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

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

更新日: 7 days ago

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

組織の所有者は、すべてのアクティブなプロジェクトとアーカイブ済みプロジェクトを Projects ページで表示できます。API プラットフォームにおけるユーザーロールと権限について詳しく確認してください。

Image

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

プロジェクトを作成できるのは組織オーナーのみです。詳細については、ロールと権限を参照してください。

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

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

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

Image

プロジェクトの仕組み

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

プロジェクトの作成方法

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

API platform project menu with Create project highlighted under Default project

プロジェクトの名前、説明、ウェブサイトを入力し、作成を選択します。

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

プロジェクトにユーザーを追加する方法

組織に新しく追加されたメンバーは、「デフォルトプロジェクト」には自動的に追加されません。新しいメンバーは、組織への招待時に「デフォルトプロジェクトに招待」チェックボックスをオンにするか、組織への招待を承諾した後にプロジェクトへ招待できます。

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

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

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

組織とプロジェクトにおけるユーザーロールと権限

組織には「所有者」と「閲覧者」のロールがある一方、プロジェクトには「所有者」と「メンバー」のロールがあります。プロジェクトメンバーは、組織の閲覧者に相当します。各ユーザーロールに付随する権限の詳細については、以下の表を参照してください。

ロールスコープ説明
所有者組織すべてのプロジェクト、すべてのユーザー、すべての API キーを作成・表示できます。組織内のすべてのプロジェクトを

プロジェクトページ
で横断的に監視できます。組織の支出上限とプロジェクトの支出上限を設定できます。組織内の他のユーザーの使用状況情報を表示する権限を付与できます。プロジェクトをアーカイブできます。
閲覧者組織自分のプロジェクトで推論の実行、リソースの使用、キーの作成ができます。プロジェクトに追加できます。
プロジェクトの作成とユーザー管理はできません。
所有者プロジェクトメンバーのすべての権限に加えて、他のユーザーをプロジェクトに追加したり、プロジェクト名を変更したりできます。プロジェクトの支出上限を設定できます。プロジェクトをアーカイブできます。
メンバープロジェクトプロジェクトレベルで推論の実行、リソースの使用、キーの作成ができます。

組織のオーナーでない場合にアクセスできる範囲

組織のオーナーではないユーザーに表示されるのは、自分がメンバーになっているプロジェクトのみです。すべてのプロジェクト、メンバー、プロジェクト単位の API キーを表示し、プロジェクトページにアクセスできるのは、組織のオーナーのみです。

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

  • プロジェクトのメンバーは、そのプロジェクトに所属する他のメンバーと各メンバーのロール(オーナーまたはメンバー)を確認できます。

ユーザーのプロジェクトロールを変更する、またはユーザーをプロジェクトから削除する方法

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

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

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

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

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

プロジェクトへのメンバーの追加

+ メンバーを追加ボタンをクリックすると、組織内で閲覧者ロールを持つユーザーの一覧が表示されます。現在組織に所属していないユーザーを追加する場合は、まずそのユーザーを組織に追加する必要があります(より広いアクセス権を付与したくない場合は、「デフォルトプロジェクトに追加」チェックボックスをオフのままにできます)。この一覧にはサービスアカウントは表示されません。この手順では、ユーザーのロールをオーナーまたはメンバーから選択できます。

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

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

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

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

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

次に、組織設定 -> プロジェクト -> メンバーの順に移動し、+ サービスアカウントをクリックします。

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

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

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

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

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

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

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

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

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

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

サービスアカウントは通常のアカウントと同様に管理されます。Organization -> Members メニューから、サービスアカウントを削除したり、ロールを更新したりできます。

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

組織のプロジェクト内で API キーを管理する方法

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

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

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

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

権限には、「すべて」「制限付き」「読み取り専用」の 3 段階があります。

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

  • 制限付き — エンドポイントごとに「なし」「読み取り」「書き込み」の権限を設定できます。

  • たとえば、/v1/assistants エンドポイントに対する読み取り権限も書き込み権限も持たない API キーを作成できます。

Create new secret key dialog in the API platform with Restricted permissions selected
  • 読み取り専用 — すべてのエンドポイントに読み取り権限が設定されます。

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

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

組織のプロジェクトのレート制限を設定・管理するには?

プロジェクトレベルのレート制限を設定および管理できるのは、組織のオーナーのみです。詳細については、ロールと権限を参照してください。


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

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

組織のプロジェクトに利用上限額を設定し、管理する方法

プロジェクトの利用上限額を設定・管理できるのは、組織のオーナーとプロジェクトのオーナーのみです。詳しくは、ロールと権限をご覧ください。組織レベルの上限を変更するには、組織設定上限をクリックし、使用量の上限までスクロールします。

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

プロジェクトの上限を設定するには、組織設定で更新するプロジェクトをクリックし、上限を選択します。月間利用上限額通知しきい値モデルの使用状況を更新できます。


月間利用上限額を設定すると、プロジェクトの支出にソフトリミットを設けられます。暦月(UTC)内の使用量がこの上限を超えても、API リクエストは中断されることなく処理され続けます。この機能は、利用上限額のアラートによる使用状況の監視を目的としており、支出に厳格な上限を適用するものではありません。プロジェクトの利用上限額を作成すると、デフォルトでは 100% のしきい値でアラートが作成されます。アラートを追加をクリックすると、異なるしきい値のアラートを追加できます。

組織のオーナーとプロジェクトのオーナーには常にこれらのメッセージが送信され、この設定は変更できません。

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

組織またはプロジェクトの支出上限の設定

OpenAI は現在、組織レベルとプロジェクトレベルの両方で月間 API 支出上限をサポートしています。支出上限は、強制せずに支出を監視するために使用することも、ハードリミットとして適用し、支出が上限に達した後は API リクエストが失敗するようにすることもできます。最新の設定手順と動作については、開発者向けドキュメントの Spend limits を参照してください。

プロジェクトを削除またはアーカイブする方法

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

同じプロジェクト一覧ページの「アーカイブ済み」タブで、アーカイブされたすべてのプロジェクトを確認できます。

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

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

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

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

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

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

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

プロジェクトごとのファイルストレージ容量

OpenAI では現在、プロジェクトごとに 100 GB のファイルストレージを使用できます。

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

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

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

プロジェクトオーナーなのに、プロジェクトの使用状況ダッシュボードが表示されない理由

プロジェクトの使用状況ダッシュボードが表示されるかどうかは、プロジェクト内でのユーザーのロールとは関係ありません。表示の可否は、組織内でのロールhttps://platform.openai.com/settings/organization/data-controls/visibility の設定によって決まります。

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

使用状況ダッシュボードが表示されない場合、この設定が「組織のオーナーに表示」になっている可能性があります。

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