OCI OpenAI互換のSDKの開始

OCI OpenAIパッケージは、OCI生成AIチームによって開発および管理されるライブラリです。このパッケージは、OpenAI互換のPythonとJava SDKおよびOCI生成AIサービスの統合を合理化します。組込みの認証および認可により、OCI資格証明を使用して生成AIサービスに安全に接続できます。

主な利点

  • OpenAI SDKの上にOCI認証レイヤーを追加して、OpenAI互換のSDK (PythonおよびJava)とOCI生成AIサービスの間の統合を簡素化し、OCI認証をシームレスに使用できるようにします。
  • OpenAI互換のSDKのサブセットと連携し、OpenAI APIに精通している開発者のコーディングを簡素化します。
  • オンボーディング・タスクを減らして、OCI生成AIモデルのサブセットに簡単に接続できます。
  • OpenAI互換エンドポイントからOCI生成AIエンドポイントにコードを移植するためのシームレスな方法を提供します。OpenAIスタイルのAPIキーを使用している場合、完全な互換性のためにAPIキーを使用できるようになりました。

サポートされているOpenAI SDK

OCI OpenAIパッケージでは、次のAPIに対してOpenAI互換のPythonおよびJava SDKがサポートされます:

重要

OCI OpenAIパッケージは、OpenAI SDKの上に独自の認証レイヤーを追加します。互換性があるのは、チャット完了APIのみです。他のOpenAI APIを使用すると、エラーが発生します(たとえば、404)。

インストール

Python

次のコマンドを使用して、OCI OpenAI Pythonパッケージをインストールします:

pip install oci-openai
Java
Maven CentralからOCI OpenAI Java SDKをMaven依存関係として追加します。pom.xml (最新リリースのバージョン0.1.22)に次を含めます。
<dependency>
    <groupId>com.oracle.genai</groupId>
    <artifactId>oci-openai-java-sdk</artifactId>
    <version>0.1.22</version>
</dependency>

リポジトリ: Maven Central

サポートされるモデル

OCI OpenAIパッケージでは、OCI生成AIでホストされている次のモデルのみがサポートされます。各モデルについて、オンデマンド・モードと専用モードのどちらで提供されているかを確認します。各モデルのサポートされているリージョンについては、サポートされているリージョンを参照してください。

チャット完了APIのモデル
重要

xAI Grokモデルへの外部コール

xAI Grokモデルは、xAI用にプロビジョニングされたテナンシ内のOCIデータ・センターでホストされます。OCI Generative AIサービスを介してアクセスできるxAI Grokモデルは、xAIによって管理されます。

サポートされるリージョン

OCI OpenAIパッケージは、次のリージョンでサポートされています。

  • ドイツ中央部(フランクフルト)
  • インド南部(ハイデラバード)
  • 日本中央部(大阪)
  • 米国東部(アッシュバーン)
  • 米国中西部(シカゴ)
  • 米国西部(フェニックス)

特定のモデルがこれらのリージョンのいずれかで使用可能であり、必須モード(オンデマンドまたは専用)と互換性があるかどうかを確認するには、次のステップに従います。

  1. リージョン別生成AIモデル・ページを開きます。
  2. 使用するモデル(Meta Llama、xAI Grok、OpenAI gpt-ossなど)については、ページにリストされている使用可能なリージョンに注意してください。
  3. 前のリストの両方およびリージョン・ページの両方のモデルで使用可能なリージョンを選択します。
  4. モデルが必要なモード(オンデマンドまたは専用)で使用可能かどうかを確認します。

    専用モードでモデルにアクセスする場合、パブリック・エンドポイントとプライベート・エンドポイントの両方がサポートされます。