calesthio/OpenMontage · error · ValueError

video_list items must include video_url

Error message

video_list items must include video_url

What it means

Error "video_list items must include video_url" thrown in calesthio/OpenMontage.

Source

Thrown at tools/video/kling_official_video.py:567

            add_image(normalize_image_input(path=path), kind="reference_image_paths")
        return image_list, references_used

    def _normalize_omni_video_list(
        self,
        inputs: dict[str, Any],
    ) -> tuple[list[dict[str, Any]], list[dict[str, Any]]]:
        if inputs.get("reference_video_path") or inputs.get("video_paths"):
            raise ValueError("Video Omni requires video URLs; local video paths cannot be silently uploaded.")

        video_list: list[dict[str, Any]] = []
        references_used: list[dict[str, Any]] = []

        def add_video(item: dict[str, Any], source_type: str) -> None:
            if item.get("video_path"):
                raise ValueError("Video Omni requires video URLs; local video paths cannot be silently uploaded.")
            video_url = item.get("video_url") or item.get("url")
            if not video_url:
                raise ValueError("video_list items must include video_url")
            record = {"video_url": video_url}
            if item.get("refer_type"):
                record["refer_type"] = item["refer_type"]
            if "keep_original_sound" in item:
                value = item["keep_original_sound"]
                record["keep_original_sound"] = "yes" if value is True else "no" if value is False else value
            video_list.append(record)
            references_used.append(
                {
                    "kind": "video",
                    "source": video_url,
                    "source_type": source_type,
                    "refer_type": record.get("refer_type"),
                    "keep_original_sound": record.get("keep_original_sound"),
                }
            )

        for item in inputs.get("video_list") or []:

View on GitHub (pinned to 95e1c3d0ab)

Solutions

  1. Include a video_url key in every video_list item.
  2. Verify each URL is publicly reachable before submitting.

When it happens

Trigger: A video_list entry lacks video_url, so no source video can be resolved for the Omni request.

Common situations: See trigger scenarios.


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