OCIチャット完了API
チャット完了APIを中心にアプリケーション・コードがすでに構築されている場合、またはよりシンプルなステートレス・チャット・インタフェースが必要な場合は、OCIチャット完了APIを使用します。新しいアプリケーションでは、OCIレスポンスAPIを使用することをお薦めします。OCI管理のマルチターン会話履歴が必要な場合は、Responses APIを会話APIとともに使用します。
ノート
OCI Chat Completions APIは、OCI OpenAI互換エンドポイントを含むOpenAI Chat Completions APIと同じ形式を使用します。構文およびリクエストの詳細は、OpenAI Chat Completions APIのドキュメントを参照してください。
OCI Chat Completions APIは、OCI OpenAI互換エンドポイントを含むOpenAI Chat Completions APIと同じ形式を使用します。構文およびリクエストの詳細は、OpenAI Chat Completions APIのドキュメントを参照してください。
必要な場合は、レスポンスAPIを使用します。
- サポートされているツール
- マルチステップ・ワークフロー
- 構造化出力
- OCI管理の会話履歴
- エージェント・ワークフローのプライマリ・インタフェース
次の場合は、チャット完了APIを使用します。
- すでにアプリケーション・コードが
/chat/completionsを中心に構築されています - よりシンプルなステートレス・チャット・インターフェースが必要
- サポートされているツールやOCI管理の会話状態などのResponses API機能は必要ありません
サポートされているAPIエンドポイント
| ベースURL | エンドポイント・パス | 認証 |
|---|---|---|
https://inference.generativeai.${region}.oci.oraclecloud.com/openai/v1 |
/chat/completions |
APIキーまたはIAMセッション |
${region}を、us-chicago-1などのサポートされているリージョンに置き換えます。
リクエスト形式はOpenAIと互換性がありますが、認証ではOCI資格証明が使用され、リクエストはOCI生成AI推論エンドポイントを介してルーティングされ、リソースと実行はOCIに残ります。
レスポンスAPIまたはチャット完了?
| ディメンション | OCIレスポンスAPI | チャット完了APIを使用したOCIチャットAPI |
|---|---|---|
| 主用途 | モデル・インタラクションとエージェント機能のための統合API | モデル・インタラクションのためのAPI |
| 最適 | 対話型チャット、エージェントのワークロード、長時間実行タスク | 対話型のチャットボットとテキスト補完 |
| オーケストレーション | 組み込みのマルチステップ推論と複数のツールコール | 単一ステップの推論または生成。マルチステップ・フローでは外部オーケストレーションが必要 |
| コンテキスト管理 | デフォルトではステートフル(オプションのステートレス使用) | クライアントが会話履歴を管理する場合のみステートレス |
| ツールのサポート | ファイル検索、コード・インタプリタ、リモートMCPなどの組込みツール | 関数呼び出しによるクライアント側のツールに限定 |
| マルチモーダルサポート | テキストおよびイメージの入力およびテキスト出力をサポートします。 | 主にテキストで、モデルに応じてマルチモーダルがサポートされます。 |
| ストリーミング | ファイングレイン・イベントによるイベントベースのストリーミング | トークンベースのストリーミング |
| 構造化出力 | ネイティブな構造化出力とJSONスキーマの適用 | JSONモードはサポートされていますが、作成は少なくなっています |
| ファイルとベクターの統合 | Files APIおよびVector Stores APIとともに使用できます。 | 個別のオーケストレーションが必要 |
| 拡張性 | ツール対応のワークフロー、メモリーおよびコンテナ用に設計されています。 | 主にチャット・アプリケーション用に設計されています。 |