Nodaro と Make の連携

Make は、シナリオから Nodaro のどのワークフローでも開始でき、完成した画像、動画、オーディオをカスタム Webhook で受け取れます。生成は Nodaro が行います。いつ実行し、結果を次にどこへ送るかは、Make が決めます。どちらの方向にも Nodaro の API キーは要りません。ワークフロー自身の Webhook のアドレスが、実行を開始するからです。

連携の仕組み

1. HTTP アプリの Make a request（リクエストを送信）モジュールが、プロンプトなどを含む JSON 本文を、Nodaro のワークフローの Webhook のアドレスに POST します。
2. Nodaro のワークフローは Webhook トリガーで始まり、ノードを実行して、Webhook 出力で終わります。
3. Webhook 出力が結果を Make の Custom webhook（カスタム Webhook）に POST し、その結果で 2 つ目のシナリオが始まります。

ステップ 1：Make で結果を受け取る

Nodaro のワークフローには受け取る側のアドレスが必要なので、受け取る側を先に作ります。

1. シナリオを作成し、トリガーとして Webhooks › Custom webhook（Webhook › カスタム Webhook）モジュールを追加します。
2. Webhook の横にある Add（追加）をクリックし、「Nodaro result」（Nodaro の結果）などの名前を付けて、Save（保存）をクリックします。
3. Make が生成した URL をコピーします。これで Make は、最初のリクエストを待ち受けます。

Make の Webhook は、それぞれ 1 つのシナリオに属します。準備ができたらシナリオをオンにして、届いた結果をすべて処理するようにします。

ステップ 2：Nodaro のワークフローを構築する

1. Webhook トリガーノードを追加します。出力パラメーターで、prompt という名前で、タイプがテキストのパラメーターを追加します。
2. prompt 出力を、画像生成ノード、または結果を作るほかのノードのプロンプト入力に接続します。
3. Webhook 出力ノードを追加します。Make の Webhook の URL を Webhook URL に貼り付けます。入力パラメーターで、タイプが画像 URL の image_url を追加し、画像をそこに接続します。
4. ワークフローを保存します。Webhook トリガーを選択し、Webhook URL の下にあるアドレスをコピーします。

アドレスは https://app.nodaro.ai/v1/webhooks/<token> という形式です。トークンはパスワードと同じように働きます。アドレスを知っている人は誰でも、ワークフローを開始できます。

ステップ 3：Make から実行を開始する

1. 実行を開始するシナリオに、HTTP アプリの Make a request モジュールを追加します。
2. Nodaro のアドレスを URL に貼り付け、Method（メソッド）を POST にします。
3. Body content type（本文のコンテンツタイプ）を application/JSON に、Body input method（本文の入力方法）を Data structure（データ構造）にします。prompt という名前のフィールドを追加し、前のモジュールから値をマッピングします。
4. 次のモジュールで executionId をマッピングできるように、Parse response（レスポンスを解析）を Yes（はい）にします。

Data structure の方法では、値がエスケープされます。値をマッピングした生の JSON 文字列は、値に引用符が含まれると壊れることがあります。

返ってくるもの

Nodaro は、何かを生成する前に、すぐにリクエストに応答します。応答は 202 で、実行の ID が含まれます。

{ "executionId": "3f9e2b1a-7c6d-4e5f-8a9b-0c1d2e3f4a5b", "status": "pending" }

実行が終わると、Webhook 出力が結果をカスタム Webhook に POST します。本文には入力パラメーターごとに 1 つのキーがあり、メディアの値は Nodaro 上のファイルのアドレスです。

{ "image_url": "https://cdn.nodaro.ai/images/2538b658-d2e1-42ee-890a-72ce06089feb.png" }

カスタム Webhook が待ち受けているあいだに Nodaro のワークフローを 1 回実行すると、Make が構造を学習し、image_url がマッピングできるフィールドになります。Webhook の詳細設定で、構造を手動で定義することもできます。

Webhook の代わりにポーリングする

同じシナリオの中で、個人用 API トークンを使って、ポーリングで結果を取得することもできます。ポーリングは、個人のプロジェクトにあるワークフローで使えます。

1. リクエストのモジュールの後に、Tools › Sleep（ツール › スリープ）モジュールを追加し、たとえば 30 秒に設定します。
2. Method が GET で、URL が https://app.nodaro.ai/v1/api/status/<executionId> の Make a request モジュールをもう 1 つ追加し、最初のリクエストから executionId をマッピングします。
3. トークンには、認証の種類 API key（API キー）を選びます。Key（キー）に Bearer <your API token> を入れ、ヘッダーに配置して、パラメーター名を Authorization にします。
4. ステータスが completed になったら、同じ方法で https://app.nodaro.ai/v1/api/result/<executionId> を呼び出します。応答には、実行の出力がそのアドレスとともに一覧で含まれます。

動画は数分かかることがあり、1 つの Sleep モジュールで待てる時間には上限があります。長い実行では、上の Webhook の方法のほうが簡単です。ステータスと結果の応答については、新しい入力値でワークフローを実行するで説明しています。

事前に考慮する制限

料金

Webhook トリガーと Webhook 出力は無料です。そのあいだにあるノードのクレジットを、エディターと同じ料金で支払います。上の例では、1 回の実行で Nano Banana 2 の画像 1 枚分の料金、22 クレジットがかかります。失敗したノードのために確保されたクレジットは、自動で返還されます。

同じ方法は、n8n と Zapier でも使えます。スケジュールや、ワークフローを開始するそのほかの方法については、自動化で説明しています。