Source: https://docs.sogni.ai/more-superapps/n8n-plugin/

# Sogni n8n Plugin

`n8n-nodes-sogni` is a community node that drops Sogni image, video, audio, LLM, and hosted creative-workflow generation directly into your n8n workflows. It supports all 15 image ControlNet types, Qwen Image Edit with multi-reference context images, video models including LTX-2.3, WAN 2.2, Seedance 2.0 / Fast / Mini, and HappyHorse 1.1, ACE-Step music/audio generation, Sogni Intelligence chat models (with optional access to Sogni's 24-tool hosted creative manifest), and full multi-step Creative Workflows — all pulling from your personal Sogni account.

### [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#install-from-n8n-community-nodes)[Install from n8n Community Nodes →](https://www.npmjs.com/package/n8n-nodes-sogni)

![Example Sogni n8n workflow](https://docs.sogni.ai/more-superapps/n8n-plugin/assets/workflow.png)

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#what-it-does)What it does

-   **Image generation** with optional ControlNet guidance across all 15 types (canny, openpose, depth, instantid, and more) and a dynamic _Size Preset_ dropdown that adapts to the chosen model + network.
-   **Image editing** via Qwen Image Edit 2511, with up to three context reference images per call.
-   **Video generation** with LTX-2.3, WAN 2.2, [Seedance 2.0](https://www.sogni.ai/models/seedance-2-0) / Fast / Mini, and [HappyHorse 1.1](https://www.sogni.ai/models/happyhorse-1-1) families, including text-to-video, image-to-video, reference-to-video, sound-to-video, animate, and v2v workflows.
-   **Audio generation** with ACE-Step — music or instrumental tracks with optional lyrics, BPM / time signature / key, composer mode, prompt strength, and creativity controls.
-   **Cost estimation** before generation runs (`Image / Video / Audio / LLM → Estimate Cost`) so scheduled jobs can guardrail spend.
-   **LLM chat** through Sogni Intelligence (Qwen3.5 etc.) with optional tool calls, plus a **vision path** for image description, plus a **one-click toggle** that exposes Sogni's hosted creative-tool manifest (24 tools — 18 generation: `generate_image`, `generate_video`, `generate_music`, `edit_image`, `animate_photo`, `restore_photo`, `apply_style`, `change_angle`, `dance_montage`, `extend_video`, `orbit_video`, `overlay_video`, `refine_result`, `replace_video_segment`, `sound_to_video`, `stitch_video`, `video_to_video`, `add_subtitles`; plus 6 composition: `enhance_prompt`, `compose_lyrics`, `compose_instrumental`, `compose_script`, `compose_workflow`, `compose_workflow_template`) to the model — no Tools JSON authoring required.
-   **Creative Workflows** — drive the hosted Sogni creative workflows engine end-to-end: `Start` a workflow from a saved template or an inline `steps[]` plan, then `Get`, `List`, fetch `Events`, or `Cancel`. The `Start` operation has an optional _Wait Until Terminal_ mode that polls until the run reaches a terminal status with configurable interval and timeout.
-   **Account and model introspection** — list available models, fetch model details, get the most popular model in a single call, check SOGNI and Spark balances.

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#install)Install

In n8n, open **Settings → Community Nodes**, click **Install**, and enter `n8n-nodes-sogni`. Confirm the install and restart n8n if prompted.

To install manually in a self-hosted instance:

```
npm install n8n-nodes-sogni
```

Restart n8n after the install completes.

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#configure)Configure

1.  In n8n, go to **Credentials → Add Credential**, search for "Sogni AI".
2.  Enter your Sogni username and password. Leave **App ID** empty for auto-generation.
3.  Add a Sogni node to a workflow, pick a resource (`Image`, `Video`, `Audio`, `LLM`, `Creative Workflow`, `Model`, `Account`) and operation (`Generate`, `Edit`, `Estimate Cost`, `Start`, `Get`, `Get All`, etc.).

A free Sogni account gets 50 daily Render credits — [sign up here](https://app.sogni.ai/create?code=n8n).

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#sample-workflows)Sample workflows

Text-to-image with Flux Schnell:

```
{
  "resource": "image",
  "operation": "generate",
  "modelId": "flux1-schnell-fp8",
  "positivePrompt": "A beautiful sunset over mountains",
  "network": "fast",
  "additionalFields": {
    "steps": 4,
    "tokenType": "spark",
    "downloadImages": true
  }
}
```

Music generation with ACE-Step:

```
{
  "resource": "audio",
  "operation": "generate",
  "audioModelId": "ace_step_1.5_turbo",
  "audioPositivePrompt": "Upbeat synthwave with driving bass, 80s arcade vibes",
  "audioNetwork": "fast",
  "audioDuration": 30,
  "audioAdditionalFields": {
    "musicAndLyrics": { "bpm": 128, "composerMode": true },
    "output": { "downloadAudios": true, "outputFormat": "mp3" }
  }
}
```

LLM with Sogni hosted creative tools:

```
{
  "resource": "llm",
  "operation": "generate",
  "llmModelId": "qwen3.6-35b-a3b-gguf-iq4xs",
  "llmPrompt": "Plan a one-image marketing render for a holographic dragon over Tokyo at sunset.",
  "llmAdditionalFields": {
    "useSogniHostedTools": true,
    "toolChoiceJson": "auto",
    "tokenType": "spark"
  }
}
```

Creative Workflow from a saved template (poll until terminal):

```
{
  "resource": "creativeWorkflow",
  "operation": "start",
  "cwStartMode": "template",
  "cwTemplateId": "wf_tpl_…",
  "cwInputsJson": "{ \"brief\": \"A neon city at dusk, cinematic shot\", \"aspect_ratio\": \"16:9\" }",
  "cwWait": true,
  "cwStartAdditionalFields": {
    "tokenType": "spark",
    "pollIntervalMs": 3000,
    "pollTimeoutMs": 900000
  }
}
```

Each node returns project/workflow metadata in JSON and (where applicable) downloaded binary properties (`image`, `image_1`, `audio`, `video`, …) ready for the next node.

![Image edit demo](https://docs.sogni.ai/more-superapps/n8n-plugin/assets/image-edit-demo.jpg)

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#workflow-ideas)Workflow ideas

**Daily scheduled image post.** Trigger on a cron, generate a Sogni image, route the binary output to a Discord webhook, Twitter, or Google Drive.

**Sketch-to-image pipeline.** Read a sketch from a Google Drive folder, run it through a `canny` ControlNet generation, store the result back to Drive or post to Slack.

**Qwen image edit from a form.** n8n Form Trigger → Sogni Image Edit (with the uploaded photo as `contextImage1`) → email the result back.

**LTX-2.3 text-to-video.** Use the bundled LTX 2.3 example workflow; auto-selects an available `ltx23-*` model before generation runs.

**Cost-guarded video batch.** Run `Video → Estimate Cost` first, branch on the response, and only proceed if the estimate is under your threshold. Same pattern works for `LLM → Estimate Cost` and `Audio → Estimate Cost`.

**Soundtrack-generated video pipeline.** Generate the score with `Audio → Generate`, drop it into a `Video → Generate` sound-to-video workflow, post the final clip to social.

**Agent-driven creative loop.** Use `LLM → Generate` with _Enable Sogni Hosted Tools_ on; let the model plan a multi-step creative job by emitting tool calls, then hand the plan to `Creative Workflow → Start` and poll until terminal.

**Hosted Creative Workflow template runner.** Build a workflow template once in the Sogni studio, then trigger it from any n8n event (webhook, cron, form, CRM hook) with structured inputs — the node will wait, return artifacts, and let you fan-out delivery.

The [`examples/`](https://github.com/Sogni-AI/n8n-nodes-sogni/tree/main/examples) folder in the repo ships 16 ready-to-import workflows including LTX-2.3 text-to-video, Qwen image edit, WAN animate-replace with SAM2, a Telegram poet bot, an ACE-Step music generator, a Creative Workflow template runner, and a hosted-tools LLM agent.

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#tips-for-getting-started)Tips for getting started

-   **Use `fast` network for interactive workflows, `relaxed` for batch jobs.** Fast spends SOGNI tokens for seconds-to-minutes turnaround; Relaxed spends Spark for minutes-to-hours but much cheaper.
-   **Always enable downloads in production.** Sogni S3 URLs expire after 24 hours; the downloaded binary lives with the n8n execution. (`downloadImages`, `downloadVideos`, `downloadAudios` all default on.)
-   **Match steps to model.** Flux: 4–8 steps. SD: 15–30. ControlNet: 20–30. ACE-Step Turbo: ~30.
-   **Bump the timeout for relaxed and long media.** Fast image: 60s is fine. Relaxed image: 10 min. Video relaxed: 20 min. Creative-workflow poll: 10–15 min for end-to-end multi-step plans.
-   **Pick the server-validated _Size Preset_ dropdown** on `Image → Generate` instead of guessing width/height — it adapts to the chosen model + network and prevents reject-at-server-edge surprises.
-   **Auto-resize references.** Leave `Auto Resize Video Assets` on unless you've already normalized your inputs.

## [#](https://docs.sogni.ai/more-superapps/n8n-plugin/#see-also)See also

-   [Sogni Client SDK](https://docs.sogni.ai/sogni-sdk/) — the SDK the node is built on.
-   [Sogni Intelligence](https://docs.sogni.ai/sogni-intelligence/introduction/) — the LLM platform exposed through the LLM resource.
-   [Creative Agent Skill](https://docs.sogni.ai/more-superapps/creative-agent-skill/) — the same Sogni capabilities for agent runtimes instead of n8n.
-   [npm: n8n-nodes-sogni](https://www.npmjs.com/package/n8n-nodes-sogni)
-   [Source on GitHub](https://github.com/Sogni-AI/n8n-nodes-sogni)
-   [Changelog](https://github.com/Sogni-AI/n8n-nodes-sogni/blob/main/CHANGELOG.md)