ComfyUI Node: Qwen3-TTS Save Prompt

Qwen3-TTS Save Prompt:

The Qwen3SavePrompt node is designed to facilitate the saving of voice clone embeddings, known as QWEN3_PROMPT, to disk in a format called safetensors. This node is particularly useful for AI artists and developers working with voice cloning technologies, as it allows for the preservation and reuse of voice embeddings. By saving these embeddings, you can efficiently manage and organize your voice cloning projects, ensuring that specific voice characteristics are easily accessible for future use. The node's primary function is to take a voice clone prompt and store it in a structured and secure manner, making it an essential tool for those looking to streamline their workflow in voice synthesis and cloning applications.

Qwen3-TTS Save Prompt Input Parameters:

prompt

The prompt parameter is a required input that represents the voice clone embedding you wish to save. It is of type QWEN3_PROMPT, which typically consists of a list of VoiceClonePromptItem objects. The node saves the first item in this list, which contains the necessary data for voice cloning, such as speaker embeddings and optional reference codes. This parameter is crucial as it directly influences the content and quality of the saved voice prompt.

filename

The filename parameter is a required input that specifies the name under which the voice clone embedding will be saved. It is of type STRING, with a default value of "voice_embedding". This parameter allows you to define a custom name for your saved file, making it easier to identify and retrieve specific voice prompts later. The filename should not include the .safetensors extension, as this is automatically appended during the saving process.

Qwen3-TTS Save Prompt Output Parameters:

filepath

The filepath output parameter provides the full path to the saved voice clone embedding file. It is of type STRING and indicates where the safetensors file has been stored on disk. This output is important as it confirms the successful saving of the voice prompt and allows you to locate and use the file in subsequent projects or applications.

Qwen3-TTS Save Prompt Usage Tips:

• Ensure that the prompt parameter contains valid voice clone data before attempting to save, as an empty or invalid prompt will result in an error.
• Use descriptive and unique names for the filename parameter to easily distinguish between different voice prompts, especially when managing multiple projects.

Qwen3-TTS Save Prompt Common Errors and Solutions:

Empty prompt - nothing to save

• Explanation: This error occurs when the prompt parameter is empty or contains no valid data to save.
• Solution: Verify that the prompt parameter is correctly populated with a valid QWEN3_PROMPT before invoking the save function.

Prompt file not found: <filepath>

• Explanation: This error indicates that the specified file path does not exist, possibly due to an incorrect filename or directory path.
• Solution: Double-check the filename parameter to ensure it is correct and that the directory path is valid and accessible.