AuK Local 生成 / 编辑

AuK Local 生成 / 编辑 ("AuK Local Generate / Edit") is the working node of this pack: sixteen tasks in one node, and it does the thing the rest of the open audio stack barely touches. It doesn't just generate speech, it edits it - re-record one line in someone's voice, change the emotion, kill an accent, pull a speaker out of a mix. Cloning is basically solved locally (Chatterbox, F5, Kokoro if you want speed); editing is not, and that's the job people normally open a DAW for.

How it works

The node builds a JSON payload, POSTs it to the local AuK service with a fresh UUID as request_id, then polls GET /api/v1/tasks/<id> every 0.4 seconds until the task reports succeeded, failed, cancelled or interrupted. On success it downloads the WAV (24 kHz float), loads it with torchaudio, and hands you a normal ComfyUI AUDIO plus the task metadata.

Two things to note. Cancellation propagates - cancel in ComfyUI and the node fires POST /api/v1/tasks/<id>/cancel, so the remote job stops instead of finishing in the background. And a dropped socket doesn't duplicate work - it re-checks the task by request_id up to three times, then gives up with AuK Local 服务断线超过 30 秒 if the service stays quiet. Long generations never time out; the node just waits. The 30 seconds in those errors is about audio length.

The inputs that matter

primary and secondary (displayed as 主要内容 and 声音描述 / 附加要求) are two multiline boxes whose meaning shifts with the task. For 描述生成语音 they're "what to say" and "what the voice sounds like" - 你好，欢迎使用 AuK。 and 自然、清晰、温暖 out of the box. For 参考声音克隆 the second box is usually empty and the reference arrives on input_audio. For 语音文字编辑, primary becomes the edit instruction, like the bundled example's 把'旧内容'改成'新内容'.

task - sixteen options: 描述生成语音, 参考声音克隆, 语音文字编辑, 歌词编辑, 音高编辑, 速度编辑, 音量编辑, 情绪编辑, 音色编辑, 去口音, 非语言声音编辑, 耳语转换, 语音增强, 说话人分离, 音乐人声提取, 指定说话人提取.

input_audio - optional, and ignored outright for 描述生成语音. Everything else in the task list wants audio in. It must be a standard ComfyUI AUDIO shaped [1, channels, samples]; stereo gets averaged to mono.

generation_seconds - 0.2 to 30, default 3, slider. The service enforces input + output ≤ 30s using your actual input duration and refuses with 输入 X.XXs + 输出 Y.YYs 超过 30s 限制. That's a real ceiling when you're editing a long recording. Chop first.

seed - pinned fixed by default, so identical settings give identical takes. refresh - advanced, set to increment: ComfyUI caches hard, so a rerun with identical inputs may not re-execute the node at all, and bumping this forces a fresh task. The author's tooltip is explicit that it doesn't touch the model seed.

The advanced sampler knobs - nfe_steps (4–64, default 32), cfg_strength (0–5, default 2), sway_sampling_coef (-1 to 1, default -1). Here's the trap: if the connection node is set to flash, this node overrides all three to 4 / 0.0 / -1.0 and throws your values away. The widgets don't grey out, so you can noodle with cfg_strength for an hour and change nothing. Switch the connection to base if you want to steer it.

Outputs

生成音频 is a standard AUDIO - wire it to PreviewAudio or SaveAudioAdvanced like the examples do, or into whatever consumes a voice next, like a lip-sync node. 最终指令 is the final instruction the service actually used after Qwen2.5-Omni-3B interpreted your two text boxes: when a clone comes out wrong, read it first, because it tells you whether the model misunderstood you or the model is just weak. 运行参数 JSON is the full run metadata, indented - feed it to a Show Text node; it's how you reproduce a take you liked.

Install (short version)

Search AuK Local · T8star-Aix in ComfyUI Manager and restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/Comfyui-Auk-T8

No pip dependencies - requirements.txt is a comment - but the nodes are useless without the integration package: run 启动AuK服务.cmd, keep its window open, and if you installed via Manager point token_file on the connection node at the package's absolute data/session-token. ComfyUI >=0.3.48, Windows x64 for the published package. Everything else is in the piece on the connection node (/node/AuKLocalConnection).

Common issues

输入 Xs + 输出 Ys 超过 30s 限制. The bundled editing example asks for 7 seconds of output on top of its input; that's the arithmetic.

Token or connection errors. Always the connection node, never this one.

Scheduler paused. The node reports the service's scheduler state directly - a service-side stall, not a graph problem. Restart the service and re-queue.

One honest caveat: this is a China-first release. Exact-phrase "AuK" turns up in essentially none of the English-language ComfyUI chatter - if you search r/comfyui you get silence - while the author, T8star-Aix, is known there for pruned Hunyuan releases and shared workflows on Bilibili, YouTube and OpenArt. The README and the bundled examples are your documentation.