# n8nの拡張HTTPリクエスト機能でAPI連携を次のレベルへ：新機能完全ガイド

> n8n の拡張 HTTP リクエスト機能とは、1.90.0 で AI Agent 用の HTTP Request ツールが通常のノードと同じ設定に対応した変更です。使える設定、$fromAI() の書き方、リトライや 429 への対処を公式の情報で解説します。

- URL: https://enhanced.co.jp/articles/n8n-extended-http-request-features/
- 公開日: 2025-05-03
- 更新日: 2026-10-07
- カテゴリー: [業務自動化](https://enhanced.co.jp/topics/automation/)
- タグ: API連携, HTTP, n8n, ノーコード, ワークフロー自動化, 新機能, 業務効率化
- 発行: エンハンスド株式会社 (https://enhanced.co.jp/)

---

**n8n の「拡張 HTTP リクエスト機能」とは、n8n 1.90.0（2025年4月22日公開）で、AI Agent が使う「HTTP Request ツール」を、通常の HTTP Request ノードと同じ設定ができるようにした変更です。** ページネーション・バッチ処理・タイムアウト・リダイレクト・プロキシ・cURL の取り込みがツールでも使えるようになり、`$fromAI()` で AI に値を埋めさせられるようになりました。通常の HTTP Request ノードそのものに、新しい設定項目が大量に増えたわけではありません。

> この記事は 2026年10月に、n8n の公式ドキュメントと GitHub のリリースノートをもとに全面的に書き直しました。以前の版にあった、n8n に存在しない設定項目（条件付きリトライ・キャッシュ・ストリーミング・レート制限・ファイル保存・OAuth の自動更新など）の設定例は削除しています。

## n8n 1.90.0 で何が変わったのか

n8n には、ワークフローの中で API を呼ぶための **HTTP Request ノード**があります。これとは別に、AI Agent ノードにつないで、AI が自分の判断で Web サイトや API を呼べるようにする **HTTP Request ツール**があります。ツールのほうは n8n 1.49.0（2024年7月）で加わりました。

1.90.0 では、このツールが「通常の HTTP Request ノードのツール版」に置き換えられました。公式のリリースノートが挙げている変化は次の 2 つです。

- **通常のノードの詳しい設定が、ツールでも使える**：ページネーション（Pagination）、バッチ処理（Batching）、タイムアウト（Timeout）、リダイレクト（Redirects）、プロキシ（Proxy）、cURL の取り込み
- **`$fromAI()` に対応**：パラメーターの値を、AI がプロンプトの文脈から決めて埋められる

つまり、以前の版の記事にあったような「HTTP Request ノードに新機能が入った」という話ではなく、**AI Agent から API を呼ぶときにも、ふだんの HTTP Request ノードと同じことができるようになった**という変更です。

## HTTP Request ツールを AI Agent に足す手順

1.90.0 のリリースノートに書かれている手順です。

1. キャンバスで AI Agent ノードを開く
2. 「+」のアイコンを押して、ツールの接続を足す
3. ツールの一覧から「HTTP Request Tool」を選ぶ
4. 通常の HTTP Request ノードと同じように設定する（詳しいオプションも含む）

## HTTP Request で設定できること

ツールとして使う場合も、通常のノードとして使う場合も、設定できるのは次の項目です（公式ドキュメントの HTTP Request のページより）。

### 基本の設定

| 項目 | 内容 |
|---|---|
| Method | DELETE・GET・HEAD・OPTIONS・PATCH・POST・PUT から選ぶ |
| URL | 呼び出すエンドポイント |
| Authentication | n8n が対応しているサービスなら「Predefined Credential Type」、それ以外は「Generic Credential Type」（Basic auth・Custom auth・Digest auth・Header auth・OAuth1 API・OAuth2 API・Query auth など）の資格情報を選ぶ |
| Send Query Parameters | クエリパラメーターを、欄に入力するか JSON で指定する |
| Send Headers | ヘッダーを、欄に入力するか JSON で指定する |
| Send Body | Form URLencoded・Form-Data・JSON・n8n Binary File・Raw から形式を選んで本文を送る |

API の説明書に cURL のコマンドが載っていれば、「Import cURL」に貼り付けて、これらの欄をまとめて埋めることもできます。

### オプション（Add Option から足す）

| オプション | 内容 |
|---|---|
| Array Format in Query Parameters | クエリパラメーターの配列の書き方（括弧なし・括弧のみ・番号つきの括弧） |
| Batching | 1 回にまとめる件数（Items per Batch）と、まとまりの間の待ち時間（Batch Interval、ミリ秒） |
| Ignore SSL Issues | SSL 証明書の検証に失敗しても応答を受け取る |
| Lowercase Headers | ヘッダー名を小文字にするか（初期値はオン） |
| Redirects | リダイレクトをたどるか、たどる回数の上限 |
| Response | 応答のヘッダーとステータスも返すか、2xx 以外でもエラーにしないか（Never Error）、応答の形式（Autodetect・File・JSON・Text） |
| Pagination | 複数のページに分かれた結果をまとめて取る |
| Proxy | 使う HTTP プロキシ |
| Timeout | 応答のヘッダーが返るまで待つ時間（ミリ秒）。1 つの値だけを指定する |

### ツールのときだけ使える設定：Optimize Response

AI Agent につないだときだけ、**Optimize Response** という設定が使えます。AI に渡す応答のデータを減らして、費用を抑えたり、AI が大事でない部分に気を取られないようにしたりするためのものです。

- **JSON**：データが入っている項目を指定したり、含める・除く項目を選んだりする
- **HTML**：CSS セレクターで必要な部分だけを取り出す、タグを外して中身だけにする、文字数で切る
- **Text**：文字数で切る

## `$fromAI()` で AI に値を埋めさせる

`$fromAI()` は、AI Agent につないだツールのパラメーターを、AI に埋めさせるための関数です。引数は値そのものではなく、「何を入れてほしいか」を AI に伝える手がかりです。

| 引数 | 必須 | 内容 |
|---|---|---|
| `key` | 必須 | 引数の名前。1〜64 文字で、英字・数字・`_`・`-` だけ |
| `description` | 任意 | 引数の説明 |
| `type` | 任意 | string・number・boolean・json のどれか（初期値は string） |
| `defaultValue` | 任意 | 値が決まらないときに使う値 |

公式ドキュメントの例です。

```javascript
{{ $fromAI('email') }}
```

```javascript
$fromAI("numItemsInStock", "Number of items in stock", "number", 5)
```

欄の一部だけを AI に埋めさせることもできます。たとえば次のように書くと、AI が作った件名の前に、決まった文字列が付きます。

```javascript
Generated by AI: {{ $fromAI("subject") }}
```

HTTP Request ツールなら、たとえばクエリパラメーターの値に `$fromAI()` を書いておくと、ユーザーの質問に合わせて AI が検索の言葉や ID を入れて API を呼べます。

### 式を書かずに AI に任せる方法

パラメーターの欄の右端にある星のボタンを押すと、その欄を AI が埋めるように、式が自動で設定されます。手で書いた値は上書きされるので注意してください。「X」を押すと手で書く設定に戻り、自動で作られた式を直して使うこともできます。

### 注意

- `$fromAI()` が使えるのは、**AI Agent ノードにつないだツールだけ**です。通常の HTTP Request ノードでは使えません
- Code ツールや、ツール以外のサブノードでも使えません

## よくある勘違い：存在しない設定と、代わりに使うもの

以前の版の記事に載せていた次の設定は、n8n の HTTP Request にはありません。やりたいことに近い、実在する機能を挙げます。

| 以前の版にあった設定 | 実際には | 代わりに使うもの |
|---|---|---|
| ステータスコードごとのリトライ条件、指数バックオフ | 無い | ノードの Settings タブの **Retry On Fail**（最大の回数 Max Tries と、待ち時間 Wait Between Tries (ms)） |
| エラーのときの独自の処理 | 専用の設定は無い | Settings タブの **On Error**（Stop Workflow・Continue・Continue (using error output)）。2xx 以外もエラーにしたくなければ Response の **Never Error** |
| リクエストとレスポンスで別々のタイムアウト | 無い | **Timeout**（1 つの値、ミリ秒） |
| 並列数・レート制限・429 のときの自動の減速 | 無い | **Batching**（件数と間隔）と **Retry On Fail** |
| JSONPath での応答の変換 | 無い | 後ろのノード（Code ノードなど）で加工する。ツールなら **Optimize Response** で AI に渡す項目を絞れる |
| 応答のキャッシュ、ストリーミングでの分割処理 | 無い | — |
| ファイルのパスへの保存 | 無い | Response の形式を **File** にするとバイナリのデータとして出力されるので、保存は別のノードで行う |
| OAuth のトークンの自動更新の設定、スコープを式で変える設定 | このような設定項目は無い | Authentication で OAuth2 API などの資格情報を選ぶ |
| 式の中の `$credentials`・`$statusCode`・`$error` | 公式の説明に無い | 資格情報は Authentication で選ぶ。`$response` はページネーションの式の中で使う |

### 429 エラー（リクエストが多すぎる）への対処

公式ドキュメントが挙げている方法は、次の 2 つです。

- **Batching**：「Add Option」→「Batching」で、Items per Batch に件数を、Batch Interval (ms) に間隔を入れる。たとえば 1 秒に 1 回にしたいなら、Batch Interval (ms) を `1000` にする
- **Retry On Fail**：Settings タブで Retry On Fail をオンにし、Max Tries に最大の回数、Wait Between Tries (ms) に待ち時間を入れる

### ページネーションの設定例

ページネーションは、式と組み込みの変数で組み立てます。公式のクックブックの例です。

- **応答に次のページの URL が入っている**：Pagination Mode を「Response Contains Next URL」にし、Next URL に `{{ $response.body["next-page"] }}` のような式を書く（項目名は API によって違います）
- **ページの番号で取る**：Pagination Mode を「Update a Parameter in Each Request」にし、Type を Query、Name を `page` などにして、Value に `{{ $pageCount + 1 }}` と書く（`$pageCount` は取得したページの数で、0 から数えるため）

## よくある質問

### 通常の HTTP Request ノードにも新機能が入ったのですか？

いいえ。1.90.0 で変わったのは、AI Agent が使う HTTP Request ツールです。通常のノードにすでにあった設定を、ツールでも使えるようにしました。

### `$fromAI()` は通常のワークフローでも使えますか？

使えません。AI Agent ノードにつないだツールの中だけで使えます。

### 失敗したリクエストを自動でやり直せますか？

ノードの Settings タブで Retry On Fail をオンにすると、最大の回数と待ち時間を決めてやり直せます。ステータスコードごとに条件を分ける設定はありません。

### 今の n8n でも同じ機能ですか？

はい。今の公式ドキュメントでも、HTTP Request は通常のノードとしても、AI Agent のツールとしても使えると説明されています。なお n8n は今は 2.x 系です（2026年10月5日に n8n@2.42.3 が公開）。

## まとめ

- 拡張 HTTP リクエスト機能は、n8n 1.90.0 で AI Agent 用の HTTP Request ツールを、通常の HTTP Request ノードと同じ設定に対応させた変更
- ツールでも、ページネーション・バッチ処理・タイムアウト・リダイレクト・プロキシ・cURL の取り込みが使える
- `$fromAI()` や星のボタンで、パラメーターの値を AI に埋めさせられる。使えるのは AI Agent につないだツールだけ
- リトライは Retry On Fail、429 への対処は Batching と Retry On Fail。キャッシュやストリーミングなどの設定は無い

n8n を使った業務自動化の例は、[n8nで毎日の手作業を自動化。中小企業の実例9選と始め方](https://enhanced.co.jp/articles/n8n-business-automation-examples/)でも紹介しています。

エンハンスドでは、AI と自動化ツールを組み合わせて業務の流れを作り直す支援を行っています（[AI × ハイパーオートメーション](https://enhanced.co.jp/services/ai-acceleration/hyper-automation/)）。

**あわせて読みたい**

- [n8nで毎日の手作業を自動化。中小企業の実例9選と始め方【2026年版】](https://enhanced.co.jp/articles/n8n-business-automation-examples/)
- [n8nでAIエージェントのプロンプトA/Bテストを自動化｜Supabase×OpenAI活用術](https://enhanced.co.jp/articles/n8n-agent-prompt-ab-testing/)

## 参考資料

- [Release notes 1.x（n8n Docs）](https://docs.n8n.io/changelog/release-notes-1.x)（n8n@1.90.0・n8n@1.49.0 の節）
- [n8n@1.90.0（GitHub の n8n-io/n8n のリリース）](https://github.com/n8n-io/n8n/releases/tag/n8n%401.90.0)
- [HTTP Request（n8n Docs）](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest)
- [HTTP Request node common issues（n8n Docs）](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/common-issues)
- [Use AI for parameters（n8n Docs）](https://docs.n8n.io/build/integrate-ai/ai-examples/use-ai-for-parameters)
- [How tools work（n8n Docs）](https://docs.n8n.io/build/integrate-ai/understand-ai-components/how-tools-work)
- [Pagination（n8n Docs の HTTP Request node cookbook）](https://docs.n8n.io/build/code-in-n8n/cookbook/http-request-node/pagination)
- [Work with nodes（n8n Docs）](https://docs.n8n.io/build/understand-workflows/workflow-components/work-with-nodes)

---

出典: 「n8nの拡張HTTPリクエスト機能でAPI連携を次のレベルへ：新機能完全ガイド」エンハンスド株式会社 https://enhanced.co.jp/articles/n8n-extended-http-request-features/
