JA ▾
API キーを取得

n8nでのOpenAI互換API:セットアップガイド

openai 互換 API n8n で検索した場合、答えは短く、OpenAI 認証情報の Base URL と API キーの 2 つの値だけを変更すればよいです。ワークフローの残りの部分は、他の OpenAI ノードと同じままです。

更新日:

APIターミナルにデータを送信する接続ブロックによる等尺性自動化ワークフロー

主要ポイント

開始前に必要なもの

n8n のインスタンス(クラウドまたはセルフホスト)と、このサービスの API キーが必要です。まだキーをお持ちでない場合は、API キーページで Google またはメールアドレスとパスワードによるサインアップの手順を確認できます。新規ユーザーは、そのページでワンクリックで $0.50 の無料トライアルクレジットを取得でき、有効期限は 7 日で、カードは不要です。

n8nには3つの値を入力します:

  • Base URL: https://api.onekeyllmapi.com/v1
  • APIキー: Authorization: Bearer <key>として送信され、n8nが自動的に処理します
  • モデルID: uncensored

このサービスはホストされたテキスト専用 LLM API で、/v1/chat/completions、/v1/responses、/v1/models の OpenAI リクエスト形式に従います。どのモデルベンダーの公式 API ではないため、n8n が OpenAI のチャットエンドポイントに送信するものは、テキストリクエストであればどこでも機能します。

ステップ1:認証情報の作成

n8nでCredentialsを開き、Create credentialを選択してOpenAI APIを検索します。以下のように入力します:

  1. キーをAPIキーフィールドに貼り付けてください。
  2. Organization IDは空のままにしてください。
  3. デフォルトのベースURLをhttps://api.onekeyllmapi.com/v1に置き換えます。末尾に/v1を保持し、/chat/completionsを追加しないでください。
  4. 保存します。n8nは保存時に小さなテスト呼び出しを実行します。失敗した場合は、以下のトラブルシューティングセクションにジャンプしてください。

環境ごとに1つの認証情報のみを保持してください。ステージングとプロダクションのn8nを実行している場合は、それぞれに独自のキーを割り当てて、支出を別々に確認し、一方を取り消しても他方に影響がないようにしてください。

ステップ2:シンプルなチャットワークフローの構築

接続が証明される最小限のものから始めます:手動トリガーと1つのモデル呼び出しです。

  1. Manual Triggerノードを追加します。
  2. OpenAIノード(またはBasic LLM Chain内のOpenAI Chat Modelサブノード、n8nのバージョンに応じて)を追加し、ステップ1の資格情報を選択してください。
  3. モデルについては、手動でIDを入力する方法を探してください。最新のn8nバージョンでは、リストの横にIDで指定モードが用意されています。そこにuncensoredと入力します。リストが空の場合、またはOpenAIの名前のみが表示される場合があります。これはn8nが自側でフィルタリングしているためです。
  4. このサポートチケットを2文で要約してくださいなどのプロンプトを追加し、ノードを実行します。

n8nのバージョンがリストからの選択を要求する場合は、次のセクションのHTTP Requestアプローチを使用してください。リクエスト全体を制御できるため、常に機能します。

HTTP Requestノードを使用したAPI呼び出し

HTTP Requestノードは、n8nからこのAPIを呼び出す最も予測可能な方法であり、seed、stop、top_p、toolsを含むAPIが受け入れるすべてのパラメータを公開します。以下のように構成します:

  • メソッド: POST
  • URL:https://api.onekeyllmapi.com/v1/chat/completions
  • 認証:Generic Credential Type、Header Auth、名前Authorization、値Bearer YOUR_KEY
  • 本文送信:オン、コンテンツタイプ JSON

ボディ(前のノードからデータ挿入したい場合はフィールドをExpressionに切り替えてください):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

応答テキストはchoices[0].message.contentにあります。次のノードでは{{ $json.choices[0].message.content }}で参照できます。

n8n外で同じリクエストをテストするには、ターミナルでこれを実行してください:

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

curlが動作してn8nが動作しない場合、問題はキーや残高ではなくノード設定にあります。

出力を解析するワークフロー用のJSONモード

モデルがデータを親しみやすい文章でラップするとワークフローが壊れます。JSONモードはAPIに有効なJSONオブジェクトを返すよう要求し、それをSetまたはIFノードに直接渡すことができます。ボディにresponse_formatを追加します:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

これを確実にするための2つの習慣があります。まず、JSONモードはスキーマではなく構文を保証するため、プロンプトで「JSON」という言葉を使い、キーの名前を指定してください。第二に、応答は依然としてmessage.content内の文字列として届くため、フィールドを読み取る前にCodeノードまたはJSON.parse()を含む式を追加してください。OpenAIノードでは、同じスイッチはノードオプションのResponse Formatオプションとして表示されます。

429およびその他のエラーの処理

n8nはアイテムを並列で実行するため、50行のバッチはすぐに制限に達する可能性があります。フルキーは同時リクエスト8件と1分あたり300リクエスト、トライアルキーは同時2件と1分あたり60リクエストを許可します。超過すると、APIはHTTP 429を返します。コードはrate_limited(1分あたりの数が多すぎる)またはconcurrency(一度に多すぎる)です。一時的な過負荷時には、Retry-After: 5ヘッダー付きの429が返されます。

n8nでの実用的な設定:

  • ノードを開き、Settingsに移動し、Retry On Failを有効にし、Max Triesを3または4に、Wait Between Triesを5000 msに設定します。
  • モデル呼び出しの前に アイテムのループ ノード(バッチサイズ 4〜6)を配置し、並列リクエストが 8 回を下回るようにしてください。
  • ノードの 設定 で、エラー発生時 を「エラー出力で続行」に設定できます。これにより、1 つの行のエラーが実行全体を停止させることがなくなります。

2種類の制限の詳細については、APIドキュメントをお読みください。その他のエラーは単純です。401はキーが間違っているか、ヘッダーにBearerの単語が含まれていないことを意味し、404は通常Base URLにタイプミスまたは余分なパスセグメントがあることを意味します。

トラブルシューティングチェックリスト

失敗の大部分は限られた数の原因から生じます。サービスを疑う前に、上から順に確認してください。

症状考えられる原因修正方法
保存または実行時の401キーが間違っているか、ヘッダーにBearerが含まれていないキーを再度貼り付けます。Header Authでは値がBearer で始まる必要があります
404Base URLにタイプミスまたは余分なパスがある認証情報にはhttps://api.onekeyllmapi.com/v1を正確に使用してください
モデルが見つからないモデルIDがuncensoredとして入力されていない「IDで指定」に切り替えるか、HTTPリクエストノードを使用してください
同時実行数による4298 を超える並列実行(トライアルキーでは 2)「アイテムのループ処理」でバッチ処理を行い、リトライを追加する
下流でのJSONパースエラー応答が文字列であるか、プロンプトでキーの名前を指定していないJSON.parse()で解析し、システムプロンプトでキーを説明する

サポートに連絡する際は、失敗した呼び出しからのX-Request-Idレスポンスヘッダーを含めてください。n8nでは、HTTPリクエストノードのオプションでレスポンスヘッダーとステータスを含めるを有効にすることでヘッダーを確認できます。

コストを抑えてテストする

構築中はトライアルクレジットを使用してください。同時リクエストが 2、1 分あたりのリクエストが 60 のトライアルキーはバッチ処理には低速ですが、認証情報の確認、プロンプト、解析ロジックのチェックには十分です。ワークフローをスケジュールに移動する際にフルキーに切り替えてください。

コストと合理的なワークフロー設計

料金は従量制で、入力トークン 1M あたり $0.15、出力トークン 1M あたり $0.50、前払いクレジットから課金されます。1 日あたり 1,000 通のメールを分類し、それぞれ 600 の入力トークンと 100 の出力トークンを使用するワークフローは、0.6M の入力トークン($0.09)と 0.1M の出力トークン($0.05)を使用し、1 日あたり約 $0.14 です。失敗または拒否されたリクエストは課金されないため、エラー時の再試行で請求が倍になることはありません。詳細は 料金ページをご覧ください。

プロンプトを短くし、モデルが必要とするフィールドのみを送信し、答えが簡潔であることがわかっている場合は max_tokens を設定してください。ご自身のマシンでもモデルを実行している場合は、同じクライアント設定を使用する OpenAI 互換 API を通じたローカル LLM の使用 に関する記事をご覧ください。

質問と回答

カスタムベースURLに対応するn8nノードはどれですか?

OpenAI 認証情報を使用するノードはすべてそれを使用できます。Base URL フィールドは認証情報に属しているためです。必要なパラメータを公開していないノードがある場合は、HTTP リクエストノードを使用してください。

n8nでモデルリストが空または誤って表示されるのはなぜですか?

n8nはモデルリストを自側で読み込み、フィルタリングします。モデルID「uncensored」を手動で入力するか、モデルがボディ内の単なるフィールドであるHTTPリクエストノードを使用してください。

n8nでストリーミングを使用できますか?

APIはSSEを介したストリーミングをサポートしていますが、ほとんどのn8nノードはデータを渡す前に完全な応答を待ちます。ワークフローでは、通常の非ストリーミング呼び出しの方が単純です。

ワークフローから残高を確認するにはどうすればよいですか?

GET /v1/balanceを呼び出すか、任意のレスポンスのX-Balance-USDヘッダーを読み取り、閾値を下回った際に通知するIFノードを追加してください。

キーはフォーム 1 つで完了します

アカウントを作成し、キーをコピーし、ベースURLを変更します。これでセットアップは完了です。