ComfyUI > Nodes > ComfyUI_FL-CosyVoice3 > FL CosyVoice3 Save Speaker

ComfyUI Node: FL CosyVoice3 Save Speaker

Class Name

FL_CosyVoice3_SaveSpeaker

Category
🔊FL CosyVoice3/Utilities
Author
filliptm (Account age: 2386days)
Extension
ComfyUI_FL-CosyVoice3
Latest Updated
2026-03-21
Github Stars
0.11K

How to Install ComfyUI_FL-CosyVoice3

Install this extension via the ComfyUI Manager by searching for ComfyUI_FL-CosyVoice3
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI_FL-CosyVoice3 in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

FL CosyVoice3 Save Speaker Description

Extracts and saves zero-shot speaker features from audio as a CosyVoice-compatible `.pt` file.

FL CosyVoice3 Save Speaker:

The FL_CosyVoice3_SaveSpeaker node is designed to extract zero-shot speaker features from a reference audio clip and save these features as a CosyVoice-compatible .pt file. This functionality allows you to reuse speaker presets without needing to re-upload the audio each time, streamlining the process of voice cloning and synthesis. By leveraging the official frontend_zero_shot method, the node efficiently captures and stores speaker characteristics, making it a valuable tool for those working with voice models. This node is particularly beneficial for AI artists and developers who want to create consistent and reusable speaker profiles, enhancing the flexibility and efficiency of their audio projects.

FL CosyVoice3 Save Speaker Input Parameters:

model

This parameter requires a CosyVoice model, which is essential for processing the reference audio and extracting speaker features. The model acts as the backbone for the feature extraction process, ensuring compatibility and accuracy in the results. There are no specific minimum or maximum values, but it must be a valid CosyVoice model.

reference_audio

The reference_audio parameter is the audio clip from which the speaker features will be extracted. It should be a high-quality audio file, ideally between 3 to 10 seconds long, with a maximum length of 30 seconds. The quality and length of this audio can significantly impact the accuracy of the extracted features.

reference_text

This is a transcript of the reference audio. Providing an accurate transcript can enhance the feature extraction process, although the node can auto-transcribe the audio if this parameter is left empty. The default value is an empty string, and it can be multiline to accommodate longer transcripts.

speaker_name

The speaker_name parameter is used to assign a name to the speaker preset. This name will be used as the key inside the .pt file and as the filename itself. It should be a descriptive and unique name to avoid confusion with other presets. The default value is "my_speaker," and it should not include any file extensions.

FL CosyVoice3 Save Speaker Output Parameters:

saved_path

The saved_path output parameter provides the file path where the speaker features have been saved. This path is crucial for locating the .pt file for future use, allowing you to easily access and load the speaker preset without reprocessing the audio.

FL CosyVoice3 Save Speaker Usage Tips:

  • Ensure that the reference audio is clear and free from background noise to improve the accuracy of the speaker feature extraction.
  • Use descriptive and unique names for the speaker_name parameter to easily identify and manage multiple speaker presets.
  • If possible, provide a precise reference_text to enhance the feature extraction process, especially if the audio contains complex or technical language.

FL CosyVoice3 Save Speaker Common Errors and Solutions:

ValueError: speaker_name cannot be empty.

  • Explanation: This error occurs when the speaker_name parameter is left empty or consists only of whitespace.
  • Solution: Provide a valid, non-empty string for the speaker_name parameter to ensure the preset is saved correctly.

FileNotFoundError: Speaker preset file not found

  • Explanation: This error indicates that the specified speaker preset file does not exist in the expected directory.
  • Solution: Verify that the speaker preset has been saved correctly using the FL_CosyVoice3_SaveSpeaker node and check the directory path for any discrepancies.

RuntimeError: inference_instruct2 is not available on this model.

  • Explanation: This error suggests that the model being used does not support the required inference method.
  • Solution: Ensure that you are using a compatible CosyVoice2 or CosyVoice3 model that includes the necessary inference capabilities.

FL CosyVoice3 Save Speaker Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI_FL-CosyVoice3
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

FL CosyVoice3 Save Speaker