calesthio/OpenMontage · error · ValueError

failed to probe local reference audio: {path}

Error message

failed to probe local reference audio: {path}

What it means

Error "failed to probe local reference audio: {path}" thrown in calesthio/OpenMontage.

Source

Thrown at tools/video/seedance_ark.py:1185

            proc = subprocess.run(
                [
                    ffprobe,
                    "-v",
                    "error",
                    "-show_entries",
                    "format=duration",
                    "-of",
                    "default=noprint_wrappers=1:nokey=1",
                    str(path),
                ],
                capture_output=True,
                text=True,
                timeout=10,
                check=False,
            )
            duration = float(proc.stdout.strip()) if proc.returncode == 0 else 0
        except (OSError, ValueError, subprocess.SubprocessError) as exc:
            raise ValueError(f"failed to probe local reference audio: {path}") from exc
        if not 2 <= duration <= max_seconds:
            raise ValueError(
                f"each local reference audio clip must be 2 to {max_seconds} seconds"
            )
        return duration

    @staticmethod
    def _is_remote_or_asset(value: str) -> bool:
        return value.startswith(("https://", "http://", "asset://"))

    def _validate_remote_refs(self, refs: list[Any], label: str) -> None:
        for ref in refs:
            value = str(ref)
            if not value.startswith(("https://", "http://", "asset://")):
                raise ValueError(
                    f"{label} must be a public/signed URL or asset:// ID; "
                    "Ark does not document video Base64 or local paths"
                )

View on GitHub (pinned to 95e1c3d0ab)

Solutions

1. Verify the audio file is a valid media file that ffprobe can read (`ffprobe <path>` manually).
2. Re-export or re-download the file if it is corrupt, or convert it to a standard format like mp3/wav.

When it happens

Trigger: ffprobe exits with an error when probing a local reference audio file, so its duration cannot be determined.

Common situations: See trigger scenarios.

AI-assisted analysis of calesthio/OpenMontage@95e1c3d0ab (2026-08-15). Data as JSON: /api/errors/fa7cd7b7c5615b61. Report an issue: GitHub.