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

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

更新日: 7 days ago

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

組織オーナーは、Projects ページで自分のアクティブなプロジェクトとアーカイブ済みプロジェクトをすべて表示できます。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

プロジェクトにユーザーを追加するには?

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

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

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

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

組織とプロジェクト内のユーザーロールの違いと、それぞれの権限は何ですか?

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

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

組織のオーナーでない場合、何にアクセスできますか?

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

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

  • プロジェクトのメンバーは、そのプロジェクトの他のメンバー全員とそのロール(オーナーまたはメンバーなど)を確認できます。

ユーザーのプロジェクトロールを更新したり、ユーザーをプロジェクトから削除したりするには?

ユーザーのプロジェクトロールを更新したり、ユーザーをプロジェクトから削除したりできるのは、プロジェクトのオーナーのみです。詳細については、ロールと権限を参照してください。

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

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

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

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

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

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

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 -> + 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 メニューから、サービスアカウントを削除したり、ロールを更新したりできます。

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 キーの権限を設定できます。

権限には、All、Restricted、Read Only の 3 つのレベルがあります。

  • 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 — すべてのエンドポイントに読み取り権限が設定されます。

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

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

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

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


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

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

組織のプロジェクト予算を設定・管理するには?

プロジェクト予算を設定および管理できるのは、組織のオーナーとプロジェクトのオーナーのみです。詳細については、ロールと権限を参照してください。組織レベルの上限を変更するには、組織設定Limits をクリックし、Usage limits までスクロールします。

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

プロジェクトの上限を設定するには、組織設定で更新するプロジェクトをクリックし、Limits を選択します。Monthly budgetNotification thresholdModel Usage を更新できます。


月次予算を設定すると、プロジェクトの支出に対するソフトしきい値を設定できます。特定の暦月(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 でファイルを表示および一覧表示できます。

プロジェクトオーナーなのに、自分のプロジェクトの使用状況ダッシュボードが表示されないのはなぜですか?

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

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

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

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