Description

This package, published on npm as @wiro-ai/n8n-nodes-wiroai, adds one n8n node per Wiro AI model, each with that model’s own parameters. A node starts a task through the Wiro AI API, waits for it to finish and returns the task ID, status and output URL (text models return their reply as message instead). Every node is also marked usableAsTool, so an n8n AI Agent can call it as a tool.

Two more nodes reach the rest of Wiro: Wiro Workflow runs your Wiro workflows and reads their runs, and Wiro Agent sends messages to Wiro Studio, the Workflow Agent or your own Wiro agents and returns their replies.

Demo

Watch the two-minute demo. It installs the package from npm in n8n, adds a Wiro API credential and tests it, generates an image with the Wiro P-Image node, then has an AI Agent call the same node as a tool.

—

Features

• Video Generation: Veo 3.1, Kling V3, Seedance, Hailuo, PixVerse, Runway, and more
• Image Generation: GPT Image 2, Flux 2 Pro, Seedream, Nano Banana, Qwen Image, and more
• Image Editing: Virtual Try-On, Face Swap, Background Removal, Prompt-based Editing, Style Transfer
• Audio & Speech: ElevenLabs TTS, Gemini TTS, Whisper STT, Voice Clone, Music Generation
• LLM Chat: GPT-5.2, GPT-5 Mini, Gemini 3, RAG Chat (YouTube, GitHub, Website, Documents)
• 3D Generation: Trellis 2, Hunyuan3D 2.1
• Translation: Gemma-based translation (4B, 12B, 27B) with image support
• E-Commerce: Product Photoshoot, Product Ads, Shopify Templates, UGC Creator
• HR Tools: CV Evaluator, Resume Parser, Job Description Generator, Exit Interview, Culture Fit

Each tool is implemented as a separate node for modular and easy use.

—

Workflow and Agent Nodes

Wiro Workflow

• Workflow > Run starts a run of a workflow and waits for its outputs. Pick the workflow from the list, or paste its wiro.ai link or slug. The node loads the inputs of that workflow, so you can fill each one or map them from the incoming item. Inputs you leave empty use the values saved in the workflow.
• Workflow > Get returns a workflow with the inputs it takes. Workflow > Get Many lists the workflows in your workspace or in the public gallery.
• Workflow Run > Get reads a run by its workflowtoken and can wait for it to end. Workflow Run > Get Many lists recent runs, newest first.

The node waits up to 20 minutes for a run by default (change it with Max Wait Time) and returns the run with its status, outputs and cost:

{
  "workflowtoken": "abc123",
  "status": "completed",
  "chargedUsd": 0.005,
  "outputs": {
    "image": [{ "url": "https://cdn1.wiro.ai/xyz/output_1.jpg", "mimeType": "image/jpeg" }]
  }
}

Wiro Agent

• Send Message sends a message to Wiro Studio, which picks and runs AI models for the request, to the Workflow Agent, which designs Wiro workflows, or to one of your own deployed agents. Pass the same Session, for example a chat ID, to keep a conversation going.
• Get Message reads a message and its reply again later.

The reply is in message.reply, files the agent made are in message.mediaUrls, and the model runs Studio started are in modelRuns.

Both nodes use the same credentials as the model nodes (Wiro API, or Wiro OAuth2 API when you sign in with your Wiro account), and both work as AI Agent tools. Workflow runs and agent turns are billed to the wallet of your project’s workspace, the same as model runs.

—

Installation

On a self-hosted n8n instance, an Owner or Admin can go to Settings > Community Nodes, select Install, enter @wiro-ai/n8n-nodes-wiroai, accept the risk notice and select Install. The n8n community nodes guide covers the other install methods.

For a manual install (for example inside a Docker container), run this in ~/.n8n/nodes and restart n8n:

npm install @wiro-ai/n8n-nodes-wiroai

—

Authentication

Wiro AI supports two authentication methods:

Signature-Based (Recommended)

Uses HMAC-SHA256 to sign every request. The API secret never leaves your environment.

API Key Only (Simple)

Only the API key is sent, with no signature. Best for server-side applications.

Setup:

1. Go to wiro.ai and sign up
2. Create a project at wiro.ai/panel/project/new
3. Choose your authentication method (Signature-Based or API Key Only)
4. In n8n, go to Credentials → Add new → Wiro API
5. Select your auth method and enter your credentials

See Wiro Authentication Docs for details.

Sign in with a Wiro account (OAuth2)

On n8n Cloud and on n8n running on your own computer, you can connect with your Wiro account instead of an API key:

1. On a Wiro node, set Authentication to OAuth2
2. Create a Wiro OAuth2 API credential and select Connect my account
3. Sign in to Wiro, pick the project whose wallet pays for the runs, and select Allow

Other n8n instances connect with the Wiro API credential above.

—

Usage Example

To generate a video with Kling V3:

1. Add the Wiro – Kling V3 Text-to-Video Generator node
2. Set:
– Prompt: A cat astronaut floating in space
– Duration: 5 Seconds
– Ratio: 16:9
3. Run the workflow

Output:

{
  "taskid": "abc123",
  "status": "completed",
  "url": "https://cdn1.wiro.ai/xyz/0.mp4"
}

—

Compatibility

• Node.js 18 or later (engines in package.json)
• n8n 1.85.0 or later: every node imports NodeConnectionTypes, which first shipped with n8n 1.85.0 (n8n-workflow 1.83.0)

—

Agent skill

This repository includes an agent skill, wiro-n8n, in skills/wiro-n8n/SKILL.md. It shows agents such as Claude Code, Codex and Cursor how to build n8n workflows with these nodes. Add it to your agent with:

npx skills add wiroai/n8n-nodes-wiroai --skill wiro-n8n

Resources

• Wiro AI n8n Integration Guide
• Wiro API Docs
• Wiro Model Marketplace
• n8n Custom Node Docs
• Community Node Guide

—

More from Wiro AI

| Repository | What it is |
| — | — |
| Wiro-MCP | Official MCP server for Wiro AI, @wiro-ai/wiro-mcp on npm |
| Wiro-LLM | Wiro AI provider for the Vercel AI SDK and LLM gateway examples, @wiro-ai/wiro-llm on npm |
| Wiro-Chromium-Extension | Wiro AI extension for Chrome, Edge, Opera and Brave |
| Wiro-Firefox-Extension | Wiro AI add-on for Firefox |
| Wiro-Safari-Extension | Wiro AI extension for Safari on the Mac |
| Wiro-Plugin | Wiro AI plugin for Cursor, Claude Code, Gemini CLI and Devin |
| Swift-QuickStart | WiroKit, the Wiro AI SDK for iOS |
| Kotlin-QuickStart | WiroKit, the Wiro AI SDK for Android |
| Dart-QuickStart | Wiro AI SDK for Dart and Flutter, wiro on pub.dev |
| ReactNative-QuickStart | Wiro AI SDK for React Native and Expo, @wiro-ai/wiro-react-native on npm |
| Swift-Realtime | Realtime voice AI example for iOS |
| Kotlin-Realtime | Realtime voice AI example for Android |
| Dart-Realtime | Realtime voice AI example for Flutter |
| ReactNative-Realtime | Realtime voice AI example for React Native |
| Wiro-Dify-Plugin | Wiro AI plugins for Dify: the LLM gateway as a model provider, plus image, video, speech and music tools |
| Wiro-ComfyUI | Wiro AI nodes for ComfyUI |
| hermes-wiro-provider | Wiro AI model provider plugin for Hermes Agent |
| Wiro-Zed | Wiro AI MCP server extension for Zed |
| wiro-action | GitHub Action for Wiro AI models and the LLM gateway, on the GitHub Marketplace |
| Wiro-Docs | Source of the Wiro AI API docs |

Website · Models · Docs · X

—

License

MIT