Suno by Ace Data Cloud

Suno for ComfyUI by Ace Data Cloud

Generate Suno music with your Ace Data Cloud account, retrieve the same task ID, and preview or save the finished audio in ComfyUI. These nodes call a hosted API; no local model or GPU is needed. API calls follow current Suno pricing, separate from ComfyUI credits.

简体中文 · Ace Data Cloud · Issues

| Node | Purpose | Cost | | --- | --- | --- | | Suno Submit Music (Ace Data Cloud) | Submit one music generation and display its task ID | Paid generation | | Suno Retrieve Task (Ace Data Cloud) | Query or wait for an existing task ID | Query only | | Suno Load Audio (Ace Data Cloud) | Decode the completed media link into ComfyUI AUDIO | Media download only | | Suno Generate Lyrics (Ace Data Cloud) | Submit a lyrics request with default or remi-v1 | Check current lyrics price | | Suno Retrieve Lyrics (Ace Data Cloud) | Read an existing lyrics task ID | Query only |

The AUDIO output connects to ComfyUI's Preview Audio and Save Audio nodes. The starter workflow uses the first track if a task returns multiple tracks. The music node offers all ten music model IDs in the current Suno Dify plugin; the lyrics node offers its other two model IDs. Nineteen additional schema-backed nodes expose all Dify tool definitions and their actions. Their media_urls_json output preserves every returned media link. Model availability and price can vary.

1. Install

Use ComfyUI's current stable release with ComfyUI-Manager. When the Registry version is active, open Manager → Custom Nodes, search Suno, confirm publisher acedatacloud and package Suno by Ace Data Cloud, then install and restart. The Registry ID is ace-suno; the source repository is AceDataCloud/SunoComfyUI.

For local source testing before Registry publication:

cd /path/to/ComfyUI/custom_nodes
git clone https://github.com/AceDataCloud/SunoComfyUI.git
cd SunoComfyUI
python -m pip install -r requirements.txt

Restart ComfyUI and search the node picker for Suno. Confirm the five guided nodes and 19 Dify tool nodes load without errors. Source availability alone does not prove Registry or Manager discovery.

2. Get a key with Suno access

1. Sign in to Ace Data Cloud Console.
2. Open an application with Suno access. Use its existing key or create a dedicated key. If you restrict API paths, allow /suno/audios, /suno/lyrics, and /suno/tasks.
3. Check the Suno service's current price and your available Credits before generating. A short prompt does not necessarily reduce the per-generation charge.
4. Set the key in the ComfyUI process environment, then restart. For a terminal installation:

export ACEDATACLOUD_API_KEY='paste-your-key-here'
python main.py --cpu

Keep the key in a private shell or process manager. Never put it in a workflow JSON, repository, screenshot, or issue. ACEDATACLOUD_API_TOKEN is also accepted. ComfyUI Desktop needs the environment configured for its own process; an export in an unrelated terminal will not reach it.

3. Submit one task

Download 01-submit-suno.json and drag it onto the ComfyUI canvas, or use File → Open. It connects Suno Submit Music → Preview as Text so the task ID is visible on the canvas. The submit node uses this starter configuration:

• Prompt: A gentle instrumental piano melody for a sunrise.
• Model: chirp-v6 (change it only after checking price and availability).
• Instrumental: enabled.

Music models: chirp-v6, chirp-v6-wild, chirp-v6-mini, chirp-v5-5, chirp-v5, chirp-v4-5-plus, chirp-v4-5, chirp-v4, chirp-v3-5, and chirp-v3-0. Check current availability and pricing before choosing a legacy model.

Click Run once. Preview as Text displays the Suno task ID. Copy it. An accepted async submission is not a completed song. If submission times out or yields no task ID, inspect Ace request history before trying again. The plugin never retries a paid submission automatically.

4. Query the same task and preview audio

Download 02-retrieve-and-preview.json and load it in ComfyUI. Replace PASTE_YOUR_TASK_ID_HERE with the ID from step 3. Its graph is Suno Retrieve Task → Suno Load Audio → Preview Audio, plus Preview as Text on the status output.

Click Run. Retrieve waits up to 240 seconds, querying the same task ID every five seconds. A completed task returns a media URL; the next node decodes it into ComfyUI AUDIO. Play it in Preview Audio. Connect Save Audio instead if you need a file in ComfyUI's output directory.

If the task is still pending after 240 seconds, Load Audio shows a pending error. Run only this retrieve workflow again with the same task ID. Do not rerun the submit workflow to poll. A green ComfyUI queue entry alone does not prove the service task completed; the status must be succeeded and the audio must play.

5. Generate lyrics

Import 03-submit-lyrics.json, choose default or remi-v1, and run once. The node returns lyrics JSON immediately or a task ID. If it returns a task ID, import 04-retrieve-lyrics.json, paste that same ID, and query until succeeded. The lyrics node does not rerun automatically after a timeout.

6. Use the remaining Dify tools

Search Suno in the node picker for the 19 additional nodes named after every formal tool in SunoDify, including extend, cover, stems, style, formats, personas, voices, custom models, projects, and batch task lookup. Each exposes the Dify model/action choices and named fields. Leave a field empty to omit it, or supply advanced fields in parameters_json as a JSON object. Nonempty named fields override JSON. The copied published Dify API contract validates the payload before the request. Destructive delete/archive actions require confirm: true in JSON or the confirmation widget. Paid requests are sent once; only read-only queries may retry after a connection failure.

Use the returned task_id with the corresponding task lookup node. The advanced nodes expose media_urls_json and result_json, so additional tracks and non-audio results remain accessible to downstream string/JSON nodes. The five guided nodes above keep the common music-to-AUDIO path simple.

7. Check usage and troubleshoot

In Ace Data Cloud Console, find the submission by task or trace ID and check its Credits deduction. Read-only task queries should not create another music generation.

| Symptom | Action | | --- | --- | | Key missing | Set ACEDATACLOUD_API_KEY in the actual ComfyUI process, then restart. | | HTTP 401/403 | Check key validity, Suno service access, path restrictions, and content policy. | | HTTP 429 | Wait for the service limit. If submission was accepted, keep the same task ID. | | Pending | Rerun the retrieve workflow with the same task ID. | | HTTP 5xx or submit timeout | Check Ace request history before resubmitting; the task may have been accepted. | | Audio download error | Confirm the task succeeded and its Ace media URL is available. Query again without generating. |

The plugin sends your prompt to api.acedata.cloud and downloads finished audio from an Ace CDN. It reads your key from the local process environment and does not save it in workflows. Only submit content you have permission to process. See privacy notes.

Development

The nodes use conventional NODE_CLASS_MAPPINGS. requirements.txt only adds requests; ComfyUI supplies PyAV and PyTorch for MP3 decoding. There is no GPU inference, model download, browser login, or runtime package installation.

python -m unittest discover -s tests -v
python -m py_compile __init__.py client.py nodes.py

For Registry publishing, pyproject.toml uses the existing ID ace-suno, version 0.3.0, and publisher acedatacloud. Its 400×400 icon is a proportional resize of the canonical Ace logo to meet the Registry size limit.