Assistants API (v2) FAQ

Assistants API とは何ですか？

Assistants API により、開発者はアプリ内で強力な AI アシスタントを簡単に構築できます。この API により、会話履歴を管理する必要がなくなり、Code Interpreter や File Search など OpenAI ホスト型ツールへのアクセスが追加されます。この API は、サードパーティツール向けの改善された Function Calling もサポートしています。

Assistants API v1 beta はまだ使用できますか？

いいえ。2024 年 12 月 18 日時点で、ユーザーは Assistant API beta の 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 でストリーミングを利用できます。

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

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

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 でフィードバックをお寄せください。