{"record":{"id":"c01b9c8c7adbbc99","repo":"calesthio/OpenMontage","slug":"reference-to-video-with-api-family-omni-requires-i","errorCode":null,"errorMessage":"reference_to_video with api_family=omni requires image_list, video_list, element_list, or reference image URLs.","messagePattern":"reference_to_video with api_family=omni requires image_list, video_list, element_list, or reference image URLs\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"tools/video/kling_official_video.py","lineNumber":431,"sourceCode":"        references_used.extend(image_refs)\n        if image_list:\n            payload[\"image_list\"] = image_list\n\n        video_list, video_refs = self._normalize_omni_video_list(inputs)\n        references_used.extend(video_refs)\n        if video_list:\n            payload[\"video_list\"] = video_list\n\n        elements = normalize_element_list(inputs.get(\"element_list\"))\n        element_id_values = [item[\"element_id\"] for item in elements]\n        if elements:\n            payload[\"element_list\"] = elements\n            references_used.extend(\n                {\"kind\": \"element\", \"element_id\": item[\"element_id\"]}\n                for item in elements\n            )\n        if operation == \"reference_to_video\" and not any(payload.get(k) for k in (\"image_list\", \"video_list\", \"element_list\")):\n            raise ValueError(\"reference_to_video with api_family=omni requires image_list, video_list, element_list, or reference image URLs.\")\n        return payload, references_used, element_id_values\n\n    def _base_classic_payload(self, inputs: dict[str, Any]) -> dict[str, Any]:\n        model_name = str(inputs.get(\"model_name\") or inputs.get(\"model_variant\") or \"kling-v3\")\n        if model_name not in CLASSIC_VIDEO_MODELS:\n            raise ValueError(f\"model_name {model_name!r} is not supported for api_family=classic\")\n        payload: dict[str, Any] = {\n            \"model_name\": model_name,\n            \"duration\": str(inputs.get(\"duration\", \"5\")),\n            \"mode\": inputs.get(\"mode\", \"std\"),\n            \"sound\": inputs.get(\"sound\", \"off\"),\n        }\n        if inputs.get(\"cfg_scale\") is not None:\n            payload[\"cfg_scale\"] = inputs[\"cfg_scale\"]\n        if inputs.get(\"camera_control\"):\n            payload[\"camera_control\"] = inputs[\"camera_control\"]\n        self._copy_common_task_fields(inputs, payload)\n        return payload","sourceCodeStart":413,"sourceCodeEnd":449,"githubUrl":"https://github.com/calesthio/OpenMontage/blob/95e1c3d0ab93482159818560f6a8c8e866b9139f/tools/video/kling_official_video.py#L413-L449","documentation":"Error \"reference_to_video with api_family=omni requires image_list, video_list, element_list, or reference image URLs.\" thrown in calesthio/OpenMontage.","triggerScenarios":"reference_to_video with api_family=omni is called without image_list, video_list, element_list, or reference image URLs.","commonSituations":"See trigger scenarios.","solutions":["Provide at least one of image_list, video_list, element_list, or reference image URLs with the omni reference_to_video call.","Ensure the lists contain items with the required url/path fields before resubmitting."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"95e1c3d0ab93482159818560f6a8c8e866b9139f","analyzedAt":"2026-08-15T06:31:20.014Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}