開始前に必要なもの
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を検索します。以下のように入力します:
- キーをAPIキーフィールドに貼り付けてください。
- Organization IDは空のままにしてください。
- デフォルトのベースURLを
https://api.onekeyllmapi.com/v1に置き換えます。末尾に/v1を保持し、/chat/completionsを追加しないでください。 - 保存します。n8nは保存時に小さなテスト呼び出しを実行します。失敗した場合は、以下のトラブルシューティングセクションにジャンプしてください。
環境ごとに1つの認証情報のみを保持してください。ステージングとプロダクションのn8nを実行している場合は、それぞれに独自のキーを割り当てて、支出を別々に確認し、一方を取り消しても他方に影響がないようにしてください。
ステップ2:シンプルなチャットワークフローの構築
接続が証明される最小限のものから始めます:手動トリガーと1つのモデル呼び出しです。
- Manual Triggerノードを追加します。
- OpenAIノード(またはBasic LLM Chain内のOpenAI Chat Modelサブノード、n8nのバージョンに応じて)を追加し、ステップ1の資格情報を選択してください。
- モデルについては、手動でIDを入力する方法を探してください。最新のn8nバージョンでは、リストの横にIDで指定モードが用意されています。そこに
uncensoredと入力します。リストが空の場合、またはOpenAIの名前のみが表示される場合があります。これはn8nが自側でフィルタリングしているためです。 - このサポートチケットを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 で始まる必要があります |
| 404 | Base URLにタイプミスまたは余分なパスがある | 認証情報にはhttps://api.onekeyllmapi.com/v1を正確に使用してください |
| モデルが見つからない | モデルIDがuncensoredとして入力されていない | 「IDで指定」に切り替えるか、HTTPリクエストノードを使用してください |
| 同時実行数による429 | 8 を超える並列実行(トライアルキーでは 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 の使用 に関する記事をご覧ください。
