ComfyUI Node: 🔧 RVC Pitch Extraction Options

🔧 RVC Pitch Extraction Options:

The RVCPitchOptionsNode is a specialized component within the TTS Audio Suite designed to provide advanced pitch extraction options for RVC (Real-time Voice Conversion) applications. This node allows you to configure detailed pitch extraction algorithms and processing parameters, enhancing the quality and control of voice conversion tasks. By offering multiple pitch extraction methods such as RMVPE, Crepe, and others, it caters to various needs, balancing quality and processing speed. The node is particularly beneficial for users seeking to optimize voice conversion through fine-tuned pitch control, offering features like pitch guidance, autotune, and performance optimizations such as caching and batch processing. It serves as a bridge to the RVC Engine node, ensuring that voice conversion tasks are executed with precision and efficiency.

🔧 RVC Pitch Extraction Options Input Parameters:

pitch_detection

This parameter specifies the pitch extraction algorithm to be used. It offers several options, each with its own balance of quality and speed. The available methods include RMVPE, RMVPE+, Mangio-Crepe, Crepe, PM, Harvest, DIO, and FCPE. RMVPE is recommended for its balance of quality and speed, while Crepe offers the highest quality at the cost of slower processing. The default value is "rmvpe". This choice impacts the accuracy and speed of pitch extraction, influencing the overall quality of the voice conversion.

crepe_hop_length

This parameter determines the hop length for the Crepe pitch extraction method, affecting the granularity of pitch analysis. It accepts values between 16 and 512, with a default of 160. A smaller hop length can lead to more detailed pitch tracking but may increase processing time. This parameter is particularly relevant when using Crepe-based methods, allowing you to fine-tune the balance between detail and performance.

filter_radius

This parameter controls the radius of the filter applied during pitch extraction, with a range from 0 to 7. The default value is 3. A larger filter radius can smooth out pitch variations, which may be desirable for certain voice conversion tasks. Adjusting this parameter helps in managing the trade-off between pitch smoothness and responsiveness.

pitch_guidance

This parameter provides a guidance factor for pitch extraction, ranging from 0.1 to 2.0, with a default of 1.0. It influences how closely the extracted pitch follows the input signal, allowing for adjustments in pitch accuracy and stability. Higher values can lead to more stable pitch extraction, which is useful in maintaining consistent voice quality.

f0_autotune

This boolean parameter enables or disables autotune functionality during pitch extraction. When set to true, it applies autotune to the extracted pitch, potentially enhancing the musicality of the output. The default is false. This feature is useful for applications where pitch correction is desired to achieve a more polished sound.

use_cache

This boolean parameter determines whether caching is used during pitch extraction. Enabling caching (default is true) can improve performance by reusing previously computed results, especially in batch processing scenarios. It is beneficial for optimizing processing time when dealing with repetitive tasks.

batch_size

This parameter sets the number of samples processed in a single batch, with a range from 1 to 8 and a default of 1. Increasing the batch size can improve processing efficiency, particularly in environments with sufficient computational resources. It allows for parallel processing of multiple samples, reducing overall execution time.

🔧 RVC Pitch Extraction Options Output Parameters:

rvc_pitch_options

This output parameter provides a dictionary containing the validated and configured pitch extraction options. It includes all the settings specified in the input parameters, ensuring that the RVC Engine node receives the correct configuration for pitch extraction. This output is crucial for maintaining consistency and accuracy in voice conversion tasks, as it encapsulates all the necessary parameters for effective pitch processing.

🔧 RVC Pitch Extraction Options Usage Tips:

• To achieve the best balance between quality and speed, use the RMVPE method for pitch detection, especially if you are new to pitch extraction.
• If you require the highest quality pitch extraction and can afford slower processing, consider using the Crepe method with a smaller hop length for more detailed analysis.

🔧 RVC Pitch Extraction Options Common Errors and Solutions:

Invalid pitch options format

• Explanation: This error occurs when the pitch options provided are not in the expected dictionary format.
• Solution: Ensure that the pitch options are specified as a dictionary with the correct parameter names and values.

Crepe hop length out of range

• Explanation: The specified crepe_hop_length is outside the allowable range of 16 to 512. - Solution: Adjust the crepe_hop_length to a value within the specified range to ensure proper pitch extraction.

Filter radius out of range

• Explanation: The filter_radius value is not within the acceptable range of 0 to 7.
• Solution: Modify the filter_radius to fall within the valid range to avoid errors in pitch smoothing.