はじめに
n8n の OpenAI Chat Model ノードから、OCI Generative AI / Enterprise AI の OpenAI-compatible endpoint を呼び出す設定メモです。
ポイントは次の 3 つです。
-
Base URLを OCI の OpenAI-compatible endpoint に変更する - OCI Project OCID は
Organization IDではなく、OpenAI-Projectheader に入れる - Model は
By IDを選び、OCI Generative AI の model id を直接入力する
今回の例では、Model に次を指定します。
xai.grok-4.3
また、n8n 自体を OCI 上にデプロイしたい場合は、こちらの Terraform プロジェクトも参考になります。
前提
この記事では、次のものが準備済みであることを前提にします。
| 項目 | 例 |
|---|---|
| OCI Region | us-chicago-1 |
| API Key secret | sk-xxxxxxxxxxxxxxxx |
| Project OCID | ocid1.generativeaiproject.oc1.us-chicago-1... |
| Model ID | xai.grok-4.3 |
ここで重要なのは Project OCID です。
OCI Generative AI / Enterprise AI では Project を指定しますが、これは OpenAI の Organization ID ではありません。
1. n8n の OpenAI credential を設定する
n8n で OpenAI credential を開きます。
Settings → Credentials → OpenAI account
設定は次のようにします。
| n8n の項目 | 設定値 |
|---|---|
| API Key | OCI Generative AI API Key secret |
| Organization ID | 空欄 |
| Base URL | https://inference.generativeai.<region>.oci.oraclecloud.com/openai/v1 |
| Add Custom Header | ON |
| Header Name | OpenAI-Project |
| Header Value | OCI Generative AI Project OCID |
例です。
API Key:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Organization ID:
空欄
Base URL:
https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/openai/v1
Custom Header:
OpenAI-Project: ocid1.generativeaiproject.oc1.us-chicago-1.xxxxx
2. Project OCID は Organization ID に入れない
ここが一番ハマりやすいところです。
n8n の OpenAI credential には Organization ID という項目がありますが、ここに OCI Project OCID を入れてはいけません。
NG 例です。
Organization ID:
ocid1.generativeaiproject.oc1.us-chicago-1.xxxxx
正しくは、Custom Header に入れます。
OpenAI-Project: ocid1.generativeaiproject.oc1.us-chicago-1.xxxxx
つまり、OCI Generative AI / Enterprise AI を使う場合の考え方は次の通りです。
OpenAI Organization ID ではなく、
OCI Project OCID を OpenAI-Project header として渡す
3. Base URL は OCI の endpoint にする
Base URL は OpenAI ではなく、OCI の OpenAI-compatible endpoint を指定します。
https://inference.generativeai.<region>.oci.oraclecloud.com/openai/v1
今回の例です。
https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/openai/v1
<region> は、自分が使う OCI region に置き換えます。
Base URL に /openai/v1 を付け忘れると、正しく呼び出せないので注意します。
4. OpenAI Chat Model ノードで Model を By ID にする
次に、workflow 側で OpenAI Chat Model ノードを開きます。
OCI の model は、n8n の model list に表示されないことがあります。
その場合は、Model の選択で By ID を選び、model id を直接入力します。
今回の設定例です。
| 項目 | 設定 |
|---|---|
| Credential | 先ほど作成した OpenAI account |
| Model | By ID |
| Model ID | xai.grok-4.3 |
| Use Responses API | ON |
Model 欄はこのようにします。
By ID
xai.grok-4.3
5. 動作確認
たとえば、次の input を渡します。
日本で一番高い山は？
正常に動くと、次のような回答が返ってきます。
日本で一番高い山は富士山です。
標高は3,776.24mで、日本最高峰です。
n8n の output 側で generations や tokenUsageEstimate が出ていれば、OpenAI Chat Model ノードから OCI Generative AI / Enterprise AI の model を呼び出せています。
まとめ
n8n から OCI Generative AI / Enterprise AI を呼ぶ設定は、次の形にすると分かりやすいです。
n8n OpenAI Chat Model Node
|
v
OpenAI account credential
|
| API Key: OCI Generative AI API Key
| Base URL: OCI OpenAI-compatible endpoint
| Header: OpenAI-Project
v
OCI Generative AI / Enterprise AI
|
v
Model: xai.grok-4.3
今回の一番大事なポイントはこれです。
OCI Project OCID は Organization ID ではなく、OpenAI-Project header に入れる。
あとは、OpenAI Chat Model ノードの Model で By ID を選び、OCI Generative AI の model id、たとえば xai.grok-4.3 を直接指定すれば OK です。