Save Audio (WAV/FLAC/MP3/Opus):
SaveAudioStandalone saves audio from your workflow as a standalone file. It offers four file-format choices, so you can choose a format that suits how you plan to use the audio. The node is marked as an output node, making it suitable for the final saving step of an audio workflow.
Save Audio (WAV/FLAC/MP3/Opus) Input Parameters:
audio
The audio you want to save. This required input must be an AUDIO value from a compatible node. It determines the sound written to the file. No default, minimum, or maximum value is specified.
filename_prefix
A required text value used as the filename prefix when saving the audio. Its default is musicgen_audio. Change it to make saved files easier to identify, such as using a project or track name. The node passes this text to the saving utility; the provided source does not specify the complete filename pattern or a minimum or maximum length.
format
The file format to request for the saved audio. The available options are wav, flac, mp3, and opus; the default is wav. Choose the option appropriate for where you intend to use the file. This setting is passed to the saving utility, whose encoding details are not shown in the provided source.
quality
A quality setting passed to the saving utility. The available options are 128k, 192k, 320k, and V0; the default is 128k. Select a setting appropriate for your intended output, but note that the provided source does not show how the utility applies each option or whether every option affects every format.
Save Audio (WAV/FLAC/MP3/Opus) Output Parameters:
filepath
A STRING value returned by the saving utility after the node runs. It represents the saved audio file's path, which you can use to locate the result or pass to a later step that accepts a path. The provided source does not specify whether the path is absolute or relative.
Save Audio (WAV/FLAC/MP3/Opus) Usage Tips:
- Connect a compatible
AUDIOoutput, then place this node at the point where you want to save the result. - Set
filename_prefixto a recognizable project or track name so the resulting file is easier to find. - Choose
formatbased on the file type needed by your next application. Start with the defaultwavwhen you do not have a specific format requirement. - When trying
mp3oropus, compare the availablequalitysettings on a short sample before saving a longer result. The provided source does not establish how those settings affect file size or sound quality.
Save Audio (WAV/FLAC/MP3/Opus) Common Errors and Solutions:
Missing required input: audio
- Explanation: The node cannot save audio when its required
audioinput is not connected. The exact error wording depends on the application. - Solution: Connect an output of type
AUDIOtoaudioand run the workflow again.
Invalid value for format
- Explanation: A workflow may fail validation if
formatcontains a value outside the node's listed choices. The exact error wording depends on the application. - Solution: Select
wav,flac,mp3, oropusfrom the node's options.
Invalid value for quality
- Explanation: A workflow may fail validation if
qualitycontains a value outside the node's listed choices. The exact error wording depends on the application. - Solution: Select
128k,192k,320k, orV0from the node's options.
Audio file could not be saved
- Explanation: The saving utility may be unable to write the requested file. Its implementation and exact error messages are not included in the provided source, so the cause cannot be determined from the node class alone.
- Solution: Check the detailed error shown by your application. Confirm that its output location is writable, try a simple
filename_prefix, and test with the defaultwavformat to narrow down the cause.
Requested format could not be encoded
- Explanation: A format-specific failure may occur in the saving utility, but the provided source does not establish which encoders it uses or the message it would display.
- Solution: Try saving the same audio as
wav. If that succeeds, check your installation's support for the requested format and consult the detailed error message before retrying.
