Comfy-Org/ComfyUI · error · ValueError

Reference audio cannot be used without a reference image or

Error message

Reference audio cannot be used without a reference image or video.

What it means

Error "Reference audio cannot be used without a reference image or video." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_minimax.py:1101

        has_references = bool(reference_images) or bool(reference_videos) or bool(reference_audios)
        if has_frames and has_references:
            raise ValueError(
                "First/last frame and reference media are mutually exclusive. Use frames for an "
                "image-to-video prompt, or reference media for a reference-to-video prompt."
            )
        if reference_audios and not reference_images and not reference_videos:
            raise ValueError("Reference audio cannot be used without a reference image or video.")
        if not has_frames and not has_references and model["ratio"] == "adaptive":
            raise ValueError(
                "Ratio 'adaptive' is not supported for text-only requests; select an explicit aspect ratio."

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Provide a reference image or video together with the reference audio.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_minimax.py:1101 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Comfy-Org/ComfyUI@1c6d8d45b3 (2026-08-14). Data as JSON: /api/errors/627a19a08601332b. Report an issue: GitHub.