calesthio/OpenMontage · error · ValueError

{label} reference must be a public URL, asset:// ID, or exis

Error message

{label} reference must be a public URL, asset:// ID, or existing local file: {value}

What it means

Error "{label} reference must be a public URL, asset:// ID, or existing local file: {value}" thrown in calesthio/OpenMontage.

Source

Thrown at tools/video/seedance_ark.py:1025

        ref: Any,
        *,
        suffix_to_mime: dict[str, str],
        max_bytes: int,
        label: str,
    ) -> str:
        value = str(ref)
        if value.startswith("data:"):
            return self._validate_data_uri(
                value,
                suffix_to_mime=suffix_to_mime,
                max_bytes=max_bytes,
                label=label,
            )
        if self._is_remote_or_asset(value):
            return value
        path = Path(value).expanduser()
        if not path.is_file():
            raise ValueError(
                f"{label} reference must be a public URL, asset:// ID, "
                f"or existing local file: {value}"
            )
        size = path.stat().st_size
        if size >= max_bytes:
            raise ValueError(
                f"local {label} must be smaller than {max_bytes // (1024 * 1024)} MB"
            )
        suffix = path.suffix.lower()
        mime = suffix_to_mime.get(suffix)
        if not mime:
            guessed, _ = mimetypes.guess_type(path.name)
            mime = guessed if guessed in suffix_to_mime.values() else None
        if not mime:
            formats = ", ".join(sorted(suffix_to_mime))
            raise ValueError(
                f"unsupported local {label} format; expected one of {formats}"
            )

View on GitHub (pinned to 95e1c3d0ab)

Solutions

1. Pass the reference as a public/signed HTTPS URL, an asset:// ID, or a path to an existing local file.
2. Check the path or URL for typos; if local, confirm the file exists at that location.

When it happens

Trigger: A reference value is neither a public URL, an asset:// ID, nor an existing local file when validating Seedance Ark reference media.

Common situations: See trigger scenarios.

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