Assistants API (v2) FAQ

Assistants API とは何ですか？

Assistants API により、開発者はアプリ内で強力な AI アシスタントを簡単に構築できます。この API により、会話履歴を管理する必要がなくなり、Code Interpreter や File Search など OpenAI ホスト型ツールへのアクセスが追加されます。この API は、サードパーティツール向けの改善された 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 で既存のアシスタントに引き続きアクセスできます。

Assistant とは何ですか？

アシスタントは、OpenAI のモデルを使用し、ファイルへのアクセス、永続的なスレッドの維持、ツールの呼び出しができる、目的に特化した AI を表します。

Thread とは何ですか？

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

File Search ツールとは？

file_search ツールには検索のベストプラクティスが標準で複数実装されており、ファイルから適切なデータを抽出してモデルの応答を補強できます。詳しくは、開発者向けドキュメントをご覧ください。

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

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

• チャンクのオーバーラップ：400 トークン

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

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

ファイルアップロードの制限は何ですか？

ファイルをアップロードする際の制限は次のとおりです。

• 1 ファイルあたり 512 MB

• 1 ファイルあたり 5M トークン

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

• 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 を呼び出すと、2 つの Code Interpreter セッション（2 * $0.03）が作成されます。各セッションはデフォルトで 1 時間有効です。つまり、ユーザーが同じスレッド内で最大 1 時間 Code Interpreter に指示を出し続ける場合、この料金は 1 回だけ発生します。

API の File Search の料金体系はどうなっていますか？

File Search の料金は、ベクトルストアのストレージ 1 GB あたり 1 日 $0.10 です（最初の 1 GB のストレージは無料）。ベクトルストアのサイズは、ファイルが解析、チャンク化、埋め込みされた後のベクトルストアの結果サイズに基づきます。

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

• 2024 年 4 月 17 日以降に作成された Run で少なくとも 1 回使用されている場合、現在の料金（現時点では $0.10/GB/日）で請求されます。

• 2024 年 4 月 17 日から 2024 年 12 月 31 日までの間に 1 回も Run で使用されていない場合は削除されます。これは、この料金変更の発表前に作成した可能性があるものの未使用のベクトルストアに対して請求が発生するのを避けるためです。

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

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

API でストリーミングは利用できますか？

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

Assistants API で JSON モードを利用できますか？

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

Assistants API はサードパーティの Function Calling のリクエストも管理しますか？

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

OpenAI に送信したデータはどのように扱われますか？

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

DALL-E は Assistants API で利用できますか？

現時点では、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 の上限を完全に削除することを検討してください。詳しくはこちらをご覧ください。

フィードバックを送るにはどうすればよいですか？

Developer Forum、help.openai.com のヘルプセンター、または Twitter の @OpenAIDevs でフィードバックをお寄せください。