N8N Nodes for WaveSpeed AI

N8N community nodes that connect WaveSpeed AI to your workflows. Use them to submit generation jobs, manage media, and monitor task status without writing custom HTTP requests.

Available Nodes

• WaveSpeed Task Submit (recommended): Choose a model category, pick a model, and send generation parameters through a guided form.
• WaveSpeed Task Submit by JSON: Send raw JSON payloads when you need full control over request bodies.
• WaveSpeed Task Status: Poll WaveSpeed for task progress and retrieve finished outputs.
• WaveSpeed Upload Media: Upload local or remote binary assets for later use in generation nodes.
• WaveSpeed Loras: Fetch LoRA resources and select one to augment downstream generation.

Installation

1. In n8n, open Settings → Community Nodes.
2. Click Install and enter the package name n8n-node-wavespeed.
3. Wait for the installation to finish, then search for wavespeed in the node picker.

Credentials

1. Log in to the WaveSpeed dashboard and create an API key with the required scopes.
2. In n8n, add new credentials of type WaveSpeed API.
3. Paste the API key, give the credential a recognizable name, and save. All WaveSpeed nodes in a workflow can reuse the same credential entry.

Using the Nodes

WaveSpeed Task Submit

1. Set Credential to the WaveSpeed API key you configured.
2. Pick a Category to filter the available models (15 categories including text, image, audio, 3D, and training).
3. Select a Model; the node loads its description and parameters automatically.
4. Fill in the required parameters. Optional fields appear once the base inputs are complete. Built-in validation highlights missing or invalid values.
5. Execute the node to start a task. The node output contains the task identifier that you can pass to WaveSpeed Task Status.

WaveSpeed Task Submit by JSON

Use this node when you already have a JSON payload that mirrors the WaveSpeed REST API. Provide the payload in the Body Parameters field. This bypasses the form interface, so validate the schema carefully before running the workflow.

WaveSpeed Task Status

1. Supply the Task ID from a previous submit node.
2. Optionally enable automatic polling and set the polling interval/timeout.
3. The node returns task metadata and any generated assets. Use a IF node to branch on status (e.g., SUCCEEDED, FAILED, or RUNNING).

WaveSpeed Upload Media

1. Choose your Input Source:
   • Binary: pass binary data from an upstream n8n node such as HTTP Request or Read Binary File.
   • URL: provide a remote file URL; the node downloads and uploads it to WaveSpeed.
2. Confirm the file type is supported:
   • Images: JPG, JPEG, PNG, WebP, GIF, BMP, TIFF
   • Videos: MP4, AVI, MOV, WMV, FLV, WebM, MKV, 3GP, OGV
   • Audio: MP3, WAV, OGG, AAC, FLAC, WebM, M4A, Opus
3. Run the node. The response includes the media ID for later reuse in generation nodes.

WaveSpeed Loras

Fetch the list of LoRA models available to your account. Select a LoRA ID from the response and feed it into WaveSpeed Task Submit or WaveSpeed Task Submit by JSON when the target model supports LoRA blending.

Example Workflows

• Image from text: WaveSpeed Task Submit → Use Result
• Upload then generate: Read Binary File → WaveSpeed Upload Media → WaveSpeed Task Submit → Use Result
• Track long-running tasks: WaveSpeed Task Submit → WaveSpeed Task Status (poll enabled) → IF (status routing)
• Apply LoRA: WaveSpeed Loras → Set (select LoRA ID) → WaveSpeed Task Submit

Troubleshooting

• Invalid API key: Revoke and recreate the key, then update the credential entry.
• Model not available: Confirm the selected category; nodes only list models you have access to.
• Parameter validation errors: Expand the parameter group in the node and review the hints for required format/limits.
• Upload timeouts: Large assets need longer timeouts; adjust the node options or upload smaller files.
• Polling never resolves: Lower the polling interval or check task history in the WaveSpeed dashboard for stalled jobs.