n8n

フェアコードのワークフロー自動化ツール。ネイティブ AI ノードと 400 以上の統合に対応

はじめに

n8n はワークフロー自動化プラットフォームで、AI ノードをネイティブサポートしています。OpenAI 統合ではカスタム Base URL を設定でき、TokenMix の OpenAI 互換エンドポイントを指定するだけで、n8n のすべての AI ノードで TokenMix のモデルが利用できます。

前提条件

Docker で n8n をセルフホストします（推奨）：

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

http://localhost:5678 にアクセスして初期設定を完了します。

TokenMix の API キーも必要です。tokenmix.ai → コンソール → API Keys で作成してください。

セットアップ手順

ステップ 1 — 認証情報を開く

n8n のサイドバーで 認証情報 → 認証情報を追加 → OpenAI を検索します。

ステップ 2 — OpenAI 認証情報を入力

フィールド	値
API キー	TokenMix キー（`sk-tm-…`）
Base URL	`https://api.tokenmix.ai/v1`
組織 ID	空白のままにする

保存をクリックすると n8n が自動的にテストします。

ステップ 3 — AI ノードで使用

ワークフローに AI Agent・LLM Chain などのノードを追加し、作成した認証情報を選択してモデル名（例：gpt-5.4・claude-sonnet-4.6・deepseek-v4-pro）を入力します。

ステップ 4 — 実行と確認

ワークフローを実行してノード出力を確認します。TokenMix コンソール → 利用履歴 でリクエストが記録されているかも確認できます。

動作確認

ワークフローをテスト ボタンで手動実行します。ノード出力が正常なら TokenMix 経由でのルーティングが成功しています。

よくある質問

Q: OpenAI ノードが 404「model not found」を返す。 A: モデル名が TokenMix モデルページの short_id と完全に一致しているか確認してください（例：gpt-5 ではなく gpt-5.4）。n8n v2 AI ノードはノード設定のモデル名をそのまま使用します。

Q: 古いバージョンの n8n で Base URL フィールドが表示されない。 A: n8n を最新バージョンに更新してください。または HTTP Request ノードを使用して https://api.tokenmix.ai/v1/chat/completions を直接呼び出し、Authorization: Bearer sk-tm-xxx ヘッダーを追加してください。これはすべての n8n バージョンで動作します。

Q: ワークフローごとに異なるモデルを使えますか？ A: はい。認証情報は共通（同じ Base URL と API キー）で、各ノード設定でモデル名を変えるだけです。