よくある質問

Assistants API とは

Assistants API を使うと、開発者はアプリ内に高機能な AI アシスタントを簡単に構築できます。この API により会話履歴を管理する必要がなくなり、OpenAI がホストする Code Interpreter や File Search などのツールも利用できます。また、サードパーティーツール向けに改良された Function Calling にも対応しています。

Assistants API v1 ベータ版は引き続き利用できますか？

いいえ。2024年12月18日以降、Assistants API ベータ版の v1 は利用できなくなりました。現在サポートしているのは v2 のみです。API 呼び出しを v1 から v2 に移行する方法については、こちらの移行ガイドをご覧ください。

アクセスするにはどうすればよいですか？

Assistants API は OpenAI API アカウントを持つすべての方が利用できますが、非推奨となっており、2026 年 8 月に削除される予定です。新しいプロジェクトでは、代わりに Responses API を使用してください。すでに Assistants API を使用している場合は、Responses API への移行を計画してください。API が利用可能な間は、Assistants Playground で既存のアシスタントに引き続きアクセスできます。

アシスタントとは

アシスタントは、OpenAI のモデルを使用する、特定の目的に合わせて構築された AI です。ファイルへのアクセス、永続的なスレッドの維持、ツールの呼び出しが可能です。

スレッドとは

スレッドは、アシスタントとユーザーの間の会話セッションです。スレッドはメッセージ履歴を保存し、会話がモデルのコンテキスト長を超えると履歴を切り詰めることで、アプリケーション開発を簡素化します。

File Search ツールとは

file_search ツールには、検索に関する複数のベストプラクティスが標準で組み込まれています。ファイルから適切なデータを抽出し、モデルの回答を充実させるのに役立ちます。

file_search ツールでは、デフォルトで以下の設定が使用されます。

• チャンクサイズ：800 トークン

• チャンクの重複：400 トークン

• 埋め込みモデル：text-embedding-3-large（256 次元）

• コンテキストに追加されるチャンクの最大数：20

ファイルアップロードの制限事項

ファイルのアップロードには、以下の制限があります。

• 1 ファイルあたり 512 MB

• 1 ファイルあたり 500 万トークン

• 1 ベクトルストアあたり 1 万ファイル

• 1 アシスタントあたり 1 ベクトルストア

• 1 スレッドあたり 1 ベクトルストア

組織内の各プロジェクトのストレージ上限は、合計 100 GB です。

File Search ツールの制限事項

以下の既知の制限事項について、今後数か月以内の対応に向けて取り組んでいます。

1. 現在、チャンク分割、埋め込み、検索の設定は変更できません。

2. ドキュメント内の画像の解析には対応していません。

3. 構造化ファイル形式（.csv や .jsonl ファイルなど）の検索には対応していません。対応しているファイル形式をご覧ください。

Assistants API のレート制限

Assistants API のレート制限は、利用ティアやモデルには連動していません。代わりに、いくつかの例外を除き、リクエストの種類ごとにデフォルトの制限が設定されています。

• GET: 1000 RPM

• POST: 300 RPM

• DELETE: 1 分あたり 300 リクエスト

API での Code Interpreter の料金

Code Interpreter の料金は、1 セッションあたり 0.03 ドルです。アシスタントが 2 つの異なるスレッドで同時に Code Interpreter を呼び出すと、Code Interpreter のセッションが 2 つ作成されます（2 × 0.03 ドル）。各セッションはデフォルトで 1 時間有効です。そのため、ユーザーが同じスレッドで Code Interpreter に指示を続けても、1 時間以内であれば料金は 1 回分のみです。

API での File Search の料金

File Search の料金は、ベクトルストアのストレージ 1 GB あたり 1 日 0.10 ドルです（最初の 1 GB は無料です）。ベクトルストアのサイズは、ファイルの解析、チャンク分割、埋め込みの生成後に得られるベクトルストアのサイズに基づきます。

2024 年 4 月 17 日より前に作成されたベクトルストアは、2024 年末まで無料です。それ以降は、以下のいずれかの扱いになります。

• 2024 年 4 月 17 日以降に作成された Run で一度でも使用されている場合、その時点の料金（現在は 1 GB あたり 1 日 0.10 ドル）が適用されます。

• 2024 年 4 月 17 日から 2024 年 12 月 31 日までの間に、どの Run でも使用されていない場合は削除されます。これは、料金変更の発表前に作成したものの、一度も使用していないベクトルストアに料金が発生するのを防ぐためです。

作成できるアシスタントの数に制限はありますか？

組織が作成できるアシスタントの数に制限はありません。

API でのストリーミングの利用可否

はい、Assistants API ではストリーミングを利用できます。

Assistants API での JSON モードの利用可否

はい、Assistants API では、Assistants オブジェクトまたは Run オブジェクトの response_format パラメーターを使って JSON モードを利用できます。

Assistants API によるサードパーティー関数の呼び出しリクエストの管理可否

いいえ。Function Calling によって、モデルはツールを選択し、そのツールへのリクエストを所定の形式に整えることができます。ただし、サードパーティーツールの呼び出しの実行は OpenAI では管理していません。

OpenAI に送信したデータの取り扱い

プラットフォームの他の機能と同様に、OpenAI API に渡されたデータやファイルがモデルのトレーニングに使用されることはありません。データは必要に応じていつでも削除できます。Assistants API にアップロードされたデータは、ユーザーが手動で削除するまで無期限に保存されます。

Assistants API での DALL-E の利用可否

現在、DALL-E は利用できません。

Assistants API 用の UI はありますか？

Assistants API については、Playgroundをご確認ください。左サイドバーで Assistants ビューを表示し、有効にしたい Tools と互換性のあるモデルを使用していることを確認してください。

Assistants API のアシスタント指示の文字数制限

アシスタント指示フィールドの上限は 256,000 文字です。

「リクエストの処理中にサーバーでエラーが発生しました。申し訳ありません。リクエストを再試行してください。エラーが解消しない場合は、ヘルプセンター（help.openai.com）からお問い合わせください。」などのエラーが表示された場合の対処方法

このエラーが表示される場合、プロンプトが正しく設定されていない可能性があります。リクエストを何度再試行しても失敗する場合は、以下をお試しください。

1. 関数に相当するコマンドがすべて関数として扱われるよう、プロンプトの構成を見直す

2. プロンプト内のコマンドをすべて関数として tools に追加する

File Search ツールがうまく動作しない場合

File Search ツールを使用する場合は、max_prompt_tokens を 20,000 以上に設定することをおすすめします。会話が長い場合や File Search を複数回使用する場合は、この上限を 50,000 に引き上げることをご検討ください。最も質の高い結果を得るには、max_prompt_tokens の上限を完全になくすことが理想的です。

フィードバックの送信方法

開発者フォーラム、ヘルプセンター（help.openai.com）、または Twitter の @OpenAIDevs へのフィードバックをお待ちしています。