calesthio/OpenMontage · error · ValueError

image_list items must include image_url, image, or image_pat

Error message

image_list items must include image_url, image, or image_path

What it means

Error "image_list items must include image_url, image, or image_path" thrown in calesthio/OpenMontage.

Source

Thrown at tools/video/kling_official_video.py:522

            record = {"image_url": value}
            if item_type:
                record["type"] = item_type
            image_list.append(record)
            references_used.append(
                {
                    "kind": "image",
                    "source": value,
                    "source_type": kind,
                    "type": item_type,
                }
            )

        for item in inputs.get("image_list") or []:
            if not isinstance(item, dict):
                raise ValueError("image_list items must be objects")
            value = normalize_image_input(item.get("image_url") or item.get("image"), item.get("image_path"))
            if not value:
                raise ValueError("image_list items must include image_url, image, or image_path")
            record = {"image_url": value}
            if item.get("type"):
                record["type"] = item["type"]
            image_list.append(record)
            references_used.append(
                {
                    "kind": "image",
                    "source": item.get("image_url") or item.get("image_path") or item.get("image"),
                    "source_type": "image_list",
                    "type": item.get("type"),
                }
            )

        add_image(
            normalize_image_input(inputs.get("reference_image_url"), inputs.get("reference_image_path")),
            kind="reference_image",
            item_type="first_frame",
        )

View on GitHub (pinned to 95e1c3d0ab)

Solutions

1. Add image_url, image, or image_path to every image_list entry.
2. Check that the key names are spelled exactly as the API expects.

When it happens

Trigger: An image_list entry object lacks image_url, image, and image_path, so no image can be resolved.

Common situations: See trigger scenarios.

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