From c7d19bbadb85fdc9b539dba9bdd80943d4ba39cf Mon Sep 17 00:00:00 2001
From: wenjian <wenjian@example.com>
Date: Fri, 13 Feb 2026 01:51:14 +0800
Subject: [PATCH] docs: add example workflow for SoulX-Singer SVS
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Demonstrates the full pipeline: load audio → preprocess (prompt & target) → SVS inference with melody control → save output.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 workflows/.gitkeep                  |   0
 workflows/example_workflow_api.json | 112 ++++++++++++++++++++++++++++
 2 files changed, 112 insertions(+)
 delete mode 100644 workflows/.gitkeep
 create mode 100644 workflows/example_workflow_api.json

diff --git a/workflows/.gitkeep b/workflows/.gitkeep
deleted file mode 100644
index e69de29..0000000
diff --git a/workflows/example_workflow_api.json b/workflows/example_workflow_api.json
new file mode 100644
index 0000000..27e5b0f
--- /dev/null
+++ b/workflows/example_workflow_api.json
@@ -0,0 +1,112 @@
+{
+  "1": {
+    "inputs": {
+      "control": "melody",
+      "seed": 52230546,
+      "pipeline": [
+        "2",
+        0
+      ],
+      "prompt_wav": [
+        "3",
+        0
+      ],
+      "prompt_metadata": [
+        "4",
+        0
+      ],
+      "target_metadata": [
+        "5",
+        0
+      ]
+    },
+    "class_type": "RunningHub SoulX-Singer SVS Processor",
+    "_meta": {
+      "title": "RunningHub SoulX-Singer SVS Processor"
+    }
+  },
+  "2": {
+    "inputs": {},
+    "class_type": "RunningHub SoulX-Singer SVS Loader",
+    "_meta": {
+      "title": "RunningHub SoulX-Singer SVS Loader"
+    }
+  },
+  "3": {
+    "inputs": {
+      "audio": "prompt_audio.mp3",
+      "audioUI": ""
+    },
+    "class_type": "LoadAudio",
+    "_meta": {
+      "title": "Load Audio"
+    }
+  },
+  "4": {
+    "inputs": {
+      "max_merge_duration": 30000,
+      "language": "Mandarin",
+      "pipeline": [
+        "6",
+        0
+      ],
+      "audio": [
+        "3",
+        0
+      ]
+    },
+    "class_type": "RunningHub SoulX-Singer Preprocessor",
+    "_meta": {
+      "title": "RunningHub SoulX-Singer Preprocessor"
+    }
+  },
+  "5": {
+    "inputs": {
+      "max_merge_duration": 60000,
+      "language": "Cantonese",
+      "pipeline": [
+        "6",
+        0
+      ],
+      "audio": [
+        "7",
+        0
+      ]
+    },
+    "class_type": "RunningHub SoulX-Singer Preprocessor",
+    "_meta": {
+      "title": "RunningHub SoulX-Singer Preprocessor"
+    }
+  },
+  "6": {
+    "inputs": {},
+    "class_type": "RunningHub SoulX-Singer Preprocess Pipeline",
+    "_meta": {
+      "title": "RunningHub SoulX-Singer Preprocess Pipeline"
+    }
+  },
+  "7": {
+    "inputs": {
+      "audio": "target_audio.mp3",
+      "audioUI": ""
+    },
+    "class_type": "LoadAudio",
+    "_meta": {
+      "title": "Load Audio"
+    }
+  },
+  "8": {
+    "inputs": {
+      "filename_prefix": "audio/ComfyUI",
+      "audioUI": "",
+      "audio": [
+        "1",
+        0
+      ]
+    },
+    "class_type": "SaveAudio",
+    "_meta": {
+      "title": "Save Audio (FLAC)"
+    }
+  }
+}