Dropdowns for Canvas/LoRA/Steps via port choices (gradio 6.23.1)

gr.Workflow 6.23.1 renders a dropdown widget for ports carrying a
choices list: the Canvas reference offers all 16 canvas labels, LoRA
offers larry/lightx/lightx8/realism/joyfox/off, Steps offers 4/6/8/28;
the operator input ports carry the same choices for rewires. The
forgiving server-side resolvers stay as a backstop for API callers.

README.md

@@ -4,7 +4,7 @@ emoji: 🎬
 colorFrom: purple
 colorTo: indigo
 sdk: gradio
-sdk_version: 6.22.0
+sdk_version: 6.23.1
 app_file: app.py
 pinned: true
 hf_oauth: true

app.py

@@ -325,11 +325,39 @@ def _fit_keyframe(image_path, current_canvas):
     return image_path, label
 
 
-def _resolve_lora(lora, use_lora) -> str:
-    """`lora` (`larry` / `lightx` / `lightx8` / `realism` / `joyfox` / `off`) wins; the legacy bool maps onto `larry` / `off`."""
-    if isinstance(lora, str) and lora in ("larry", "lightx", "lightx8", "realism", "joyfox", "off"):
-        return lora
-    return "larry" if use_lora else "off"
+LORA_NAMES = ("larry", "lightx", "lightx8", "realism", "joyfox", "off")
+
+
+def _resolve_lora(lora, use_lora=True) -> str:
+    """Forgiving LoRA resolution for a free-text canvas field: case-insensitive, unambiguous prefixes allowed."""
+    if not isinstance(lora, str) or not lora.strip():
+        return "larry" if use_lora else "off"
+    value = lora.strip().lower()
+    if value in LORA_NAMES:
+        return value
+    matches = [name for name in LORA_NAMES if name.startswith(value)]
+    if len(matches) == 1:
+        return matches[0]
+    raise gr.Error(f"Unknown LoRA `{lora}`. Pick one of: {', '.join(LORA_NAMES)}.")
+
+
+def _resolve_canvas(canvas) -> str:
+    """Forgiving canvas resolution: the exact label, a `WxH` pair, or an unambiguous label substring (`16:9 fast`)."""
+    if not isinstance(canvas, str) or not canvas.strip():
+        return DEFAULT_CANVAS
+    value = canvas.strip()
+    if value in CANVASES:
+        return value
+    lowered = value.lower()
+    for label in CANVASES:
+        if label.lower() == lowered:
+            return label
+    matches = [label for label, (h, w) in CANVASES.items() if f"{w}x{h}" == lowered or lowered in label.lower()]
+    if len(matches) == 1:
+        return matches[0]
+    if matches:
+        raise gr.Error(f"`{canvas}` is ambiguous: {', '.join(matches)}. Give the full label or a WxH pair.")
+    raise gr.Error(f"Unknown canvas `{canvas}`. Pick one of: {', '.join(CANVASES)}.")
 
 
 def generate(prompt, image_path=None, last_image_path=None, canvas=DEFAULT_CANVAS, duration=5, steps=6, seed=42, upsample=False, use_lora=True, lora="", ip_token=None):
@@ -346,6 +374,7 @@ def generate(prompt, image_path=None, last_image_path=None, canvas=DEFAULT_CANVA
     from diffusers.utils import encode_video
 
     lora = _resolve_lora(lora, use_lora)
+    canvas = _resolve_canvas(canvas)
 
     # Keyframes arrive as FileData-style dicts (workflow canvas), plain paths, or URLs; the cover-crop /
     # canvas-fit runs here so every caller gets the same treatment.
@@ -439,7 +468,7 @@ def generate_video(prompt: str, first_frame=None, last_frame=None, canvas: str =
     if not prompt or not str(prompt).strip():
         raise gr.Error("MiniMax-H3 always takes a prompt, keyframes or not.")
     try:
-        return generate(str(prompt), first_frame, last_frame, str(canvas), float(duration), int(steps), float(seed),
+        return generate(str(prompt), first_frame, last_frame, canvas, float(duration), int(steps), float(seed),
                         bool(upsample), lora=str(lora or "larry"), ip_token=_caller_ip_token())
     except gr.Error:
         raise

requirements.txt

@@ -14,7 +14,7 @@ transformers==5.8.0
 accelerate==1.14.0
 # diffusers pins <2.
 huggingface-hub==1.24.0
-gradio==6.22.0
+gradio==6.23.1
 spaces==0.51.1
 # No `kernels` pin on purpose: the Hub attention backends want `kernels>=0.12.3`, and that version breaks
 # transformers 5.8.0 at import.

workflow.json

@@ -2,29 +2,59 @@
   "schema_version": "2",
   "name": "MiniMax-H3 Studio",
   "description": "Joint video + synchronized soundtrack from MiniMax-H3 (unquantized bf16, split deployment) with switchable turbo LoRAs, driven by a gr.Workflow fn-bound @spaces.GPU function.",
-  "runtime": { "default": "client" },
-  "view": { "default": "canvas" },
+  "runtime": {
+    "default": "client"
+  },
+  "view": {
+    "default": "canvas"
+  },
   "references": [
     {
       "id": "ref_prompt",
       "label": "Prompt",
       "role": "reference",
       "asset_type": "text",
-      "inputs": [{ "id": "in", "label": "Prompt", "type": "text" }],
-      "outputs": [{ "id": "out", "label": "Prompt", "type": "text" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Prompt",
+          "type": "text"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Prompt",
+          "type": "text"
+        }
+      ],
       "x": 40,
       "y": 60,
       "width": 280,
       "height": 140,
-      "data": { "out": "A corgi in a chef hat flipping a pancake in a sunlit kitchen, sizzling sounds and a cheerful bark, cinematic" }
+      "data": {
+        "out": "A corgi in a chef hat flipping a pancake in a sunlit kitchen, sizzling sounds and a cheerful bark, cinematic"
+      }
     },
     {
       "id": "ref_first",
       "label": "First Frame (optional)",
       "role": "reference",
       "asset_type": "image",
-      "inputs": [{ "id": "in", "label": "Image", "type": "image" }],
-      "outputs": [{ "id": "out", "label": "Image", "type": "image" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Image",
+          "type": "image"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Image",
+          "type": "image"
+        }
+      ],
       "x": 40,
       "y": 230,
       "width": 220,
@@ -36,8 +66,20 @@
       "label": "Last Frame (optional)",
       "role": "reference",
       "asset_type": "image",
-      "inputs": [{ "id": "in", "label": "Image", "type": "image" }],
-      "outputs": [{ "id": "out", "label": "Image", "type": "image" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Image",
+          "type": "image"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Image",
+          "type": "image"
+        }
+      ],
       "x": 40,
       "y": 370,
       "width": 220,
@@ -49,78 +91,194 @@
       "label": "Canvas",
       "role": "reference",
       "asset_type": "text",
-      "inputs": [{ "id": "in", "label": "Canvas label", "type": "text" }],
-      "outputs": [{ "id": "out", "label": "Canvas", "type": "text" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Canvas label",
+          "type": "text"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Canvas",
+          "type": "text",
+          "choices": [
+            "960x544 · 16:9 fast",
+            "1024x576 · 16:9 fast",
+            "1152x640 · 16:9",
+            "1280x704 · 16:9",
+            "1344x768 · 16:9 full",
+            "544x960 · 9:16 fast",
+            "640x1152 · 9:16",
+            "768x1344 · 9:16 full",
+            "544x544 · 1:1 fast",
+            "768x768 · 1:1 full",
+            "768x576 · 4:3 fast",
+            "1024x768 · 4:3 full",
+            "576x768 · 3:4 fast",
+            "768x1024 · 3:4 full",
+            "1152x512 · 21:9 fast",
+            "1536x672 · 21:9 full"
+          ]
+        }
+      ],
       "x": 40,
       "y": 520,
       "width": 220,
       "height": 90,
-      "data": { "out": "960x544 · 16:9 fast" }
+      "data": {
+        "out": "960x544 · 16:9 fast"
+      }
     },
     {
       "id": "ref_duration",
       "label": "Duration (s)",
       "role": "reference",
       "asset_type": "number",
-      "inputs": [{ "id": "in", "label": "Seconds", "type": "number" }],
-      "outputs": [{ "id": "out", "label": "Duration", "type": "number" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Seconds",
+          "type": "number"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Duration",
+          "type": "number"
+        }
+      ],
       "x": 40,
       "y": 630,
       "width": 200,
       "height": 90,
-      "data": { "out": 5 }
+      "data": {
+        "out": 5
+      }
     },
     {
       "id": "ref_steps",
       "label": "Steps",
       "role": "reference",
       "asset_type": "number",
-      "inputs": [{ "id": "in", "label": "Steps", "type": "number" }],
-      "outputs": [{ "id": "out", "label": "Steps", "type": "number" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Steps",
+          "type": "number"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Steps",
+          "type": "number",
+          "choices": [
+            4,
+            6,
+            8,
+            28
+          ]
+        }
+      ],
       "x": 40,
       "y": 740,
       "width": 200,
       "height": 90,
-      "data": { "out": 6 }
+      "data": {
+        "out": 6
+      }
     },
     {
       "id": "ref_seed",
       "label": "Seed",
       "role": "reference",
       "asset_type": "number",
-      "inputs": [{ "id": "in", "label": "Seed", "type": "number" }],
-      "outputs": [{ "id": "out", "label": "Seed", "type": "number" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Seed",
+          "type": "number"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Seed",
+          "type": "number"
+        }
+      ],
       "x": 40,
       "y": 850,
       "width": 200,
       "height": 90,
-      "data": { "out": 42 }
+      "data": {
+        "out": 42
+      }
     },
     {
       "id": "ref_upsample",
       "label": "Upsample Prompt",
       "role": "reference",
       "asset_type": "boolean",
-      "inputs": [{ "id": "in", "label": "Upsample", "type": "boolean" }],
-      "outputs": [{ "id": "out", "label": "Upsample", "type": "boolean" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Upsample",
+          "type": "boolean"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Upsample",
+          "type": "boolean"
+        }
+      ],
       "x": 40,
       "y": 960,
       "width": 200,
       "height": 90,
-      "data": { "out": false }
+      "data": {
+        "out": false
+      }
     },
     {
       "id": "ref_lora",
-      "label": "LoRA (larry / lightx / lightx8 / realism / joyfox / off)",
+      "label": "LoRA",
       "role": "reference",
       "asset_type": "text",
-      "inputs": [{ "id": "in", "label": "LoRA", "type": "text" }],
-      "outputs": [{ "id": "out", "label": "LoRA", "type": "text" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "LoRA",
+          "type": "text"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "LoRA",
+          "type": "text",
+          "choices": [
+            "larry",
+            "lightx",
+            "lightx8",
+            "realism",
+            "joyfox",
+            "off"
+          ]
+        }
+      ],
       "x": 40,
       "y": 1070,
       "width": 260,
       "height": 90,
-      "data": { "out": "larry" }
+      "data": {
+        "out": "larry"
+      }
     }
   ],
   "operators": [
@@ -132,20 +290,98 @@
       "source": "fn",
       "fn": "generate_video",
       "inputs": [
-        { "id": "in_0", "label": "prompt", "type": "text", "required": true },
-        { "id": "in_1", "label": "first_frame", "type": "image" },
-        { "id": "in_2", "label": "last_frame", "type": "image" },
-        { "id": "in_3", "label": "canvas", "type": "text" },
-        { "id": "in_4", "label": "duration", "type": "number" },
-        { "id": "in_5", "label": "steps", "type": "number" },
-        { "id": "in_6", "label": "seed", "type": "number" },
-        { "id": "in_7", "label": "upsample", "type": "boolean" },
-        { "id": "in_8", "label": "lora", "type": "text" }
+        {
+          "id": "in_0",
+          "label": "prompt",
+          "type": "text",
+          "required": true
+        },
+        {
+          "id": "in_1",
+          "label": "first_frame",
+          "type": "image"
+        },
+        {
+          "id": "in_2",
+          "label": "last_frame",
+          "type": "image"
+        },
+        {
+          "id": "in_3",
+          "label": "canvas",
+          "type": "text",
+          "choices": [
+            "960x544 · 16:9 fast",
+            "1024x576 · 16:9 fast",
+            "1152x640 · 16:9",
+            "1280x704 · 16:9",
+            "1344x768 · 16:9 full",
+            "544x960 · 9:16 fast",
+            "640x1152 · 9:16",
+            "768x1344 · 9:16 full",
+            "544x544 · 1:1 fast",
+            "768x768 · 1:1 full",
+            "768x576 · 4:3 fast",
+            "1024x768 · 4:3 full",
+            "576x768 · 3:4 fast",
+            "768x1024 · 3:4 full",
+            "1152x512 · 21:9 fast",
+            "1536x672 · 21:9 full"
+          ]
+        },
+        {
+          "id": "in_4",
+          "label": "duration",
+          "type": "number"
+        },
+        {
+          "id": "in_5",
+          "label": "steps",
+          "type": "number"
+        },
+        {
+          "id": "in_6",
+          "label": "seed",
+          "type": "number"
+        },
+        {
+          "id": "in_7",
+          "label": "upsample",
+          "type": "boolean"
+        },
+        {
+          "id": "in_8",
+          "label": "lora",
+          "type": "text",
+          "choices": [
+            "larry",
+            "lightx",
+            "lightx8",
+            "realism",
+            "joyfox",
+            "off"
+          ]
+        }
       ],
       "outputs": [
-        { "id": "out_0", "label": "video", "type": "video", "output_index": 0 },
-        { "id": "out_1", "label": "report", "type": "text", "output_index": 1 },
-        { "id": "out_2", "label": "refined_prompt", "type": "text", "output_index": 2 }
+        {
+          "id": "out_0",
+          "label": "video",
+          "type": "video",
+          "output_index": 0
+        },
+        {
+          "id": "out_1",
+          "label": "report",
+          "type": "text",
+          "output_index": 1
+        },
+        {
+          "id": "out_2",
+          "label": "refined_prompt",
+          "type": "text",
+          "output_index": 2
+        }
       ],
       "x": 460,
       "y": 420,
@@ -160,8 +396,20 @@
       "label": "Output Video",
       "role": "subject",
       "asset_type": "video",
-      "inputs": [{ "id": "in", "label": "Video", "type": "video" }],
-      "outputs": [{ "id": "out", "label": "Video", "type": "video" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Video",
+          "type": "video"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Video",
+          "type": "video"
+        }
+      ],
       "x": 880,
       "y": 380,
       "width": 280,
@@ -173,8 +421,20 @@
       "label": "Report",
       "role": "subject",
       "asset_type": "text",
-      "inputs": [{ "id": "in", "label": "Report", "type": "text" }],
-      "outputs": [{ "id": "out", "label": "Report", "type": "text" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Report",
+          "type": "text"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Report",
+          "type": "text"
+        }
+      ],
       "x": 880,
       "y": 580,
       "width": 280,
@@ -186,8 +446,20 @@
       "label": "Refined Prompt",
       "role": "subject",
       "asset_type": "text",
-      "inputs": [{ "id": "in", "label": "Refined prompt", "type": "text" }],
-      "outputs": [{ "id": "out", "label": "Refined prompt", "type": "text" }],
+      "inputs": [
+        {
+          "id": "in",
+          "label": "Refined prompt",
+          "type": "text"
+        }
+      ],
+      "outputs": [
+        {
+          "id": "out",
+          "label": "Refined prompt",
+          "type": "text"
+        }
+      ],
       "x": 880,
       "y": 720,
       "width": 280,
@@ -196,17 +468,101 @@
     }
   ],
   "edges": [
-    { "id": "e_prompt", "from_node_id": "ref_prompt", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_0", "type": "text" },
-    { "id": "e_first", "from_node_id": "ref_first", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_1", "type": "image" },
-    { "id": "e_last", "from_node_id": "ref_last", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_2", "type": "image" },
-    { "id": "e_canvas", "from_node_id": "ref_canvas", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_3", "type": "text" },
-    { "id": "e_duration", "from_node_id": "ref_duration", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_4", "type": "number" },
-    { "id": "e_steps", "from_node_id": "ref_steps", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_5", "type": "number" },
-    { "id": "e_seed", "from_node_id": "ref_seed", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_6", "type": "number" },
-    { "id": "e_upsample", "from_node_id": "ref_upsample", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_7", "type": "boolean" },
-    { "id": "e_lora", "from_node_id": "ref_lora", "from_port_id": "out", "to_node_id": "op_generate", "to_port_id": "in_8", "type": "text" },
-    { "id": "e_video_out", "from_node_id": "op_generate", "from_port_id": "out_0", "to_node_id": "sub_video", "to_port_id": "in", "type": "video" },
-    { "id": "e_report_out", "from_node_id": "op_generate", "from_port_id": "out_1", "to_node_id": "sub_report", "to_port_id": "in", "type": "text" },
-    { "id": "e_refined_out", "from_node_id": "op_generate", "from_port_id": "out_2", "to_node_id": "sub_refined", "to_port_id": "in", "type": "text" }
+    {
+      "id": "e_prompt",
+      "from_node_id": "ref_prompt",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_0",
+      "type": "text"
+    },
+    {
+      "id": "e_first",
+      "from_node_id": "ref_first",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_1",
+      "type": "image"
+    },
+    {
+      "id": "e_last",
+      "from_node_id": "ref_last",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_2",
+      "type": "image"
+    },
+    {
+      "id": "e_canvas",
+      "from_node_id": "ref_canvas",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_3",
+      "type": "text"
+    },
+    {
+      "id": "e_duration",
+      "from_node_id": "ref_duration",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_4",
+      "type": "number"
+    },
+    {
+      "id": "e_steps",
+      "from_node_id": "ref_steps",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_5",
+      "type": "number"
+    },
+    {
+      "id": "e_seed",
+      "from_node_id": "ref_seed",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_6",
+      "type": "number"
+    },
+    {
+      "id": "e_upsample",
+      "from_node_id": "ref_upsample",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_7",
+      "type": "boolean"
+    },
+    {
+      "id": "e_lora",
+      "from_node_id": "ref_lora",
+      "from_port_id": "out",
+      "to_node_id": "op_generate",
+      "to_port_id": "in_8",
+      "type": "text"
+    },
+    {
+      "id": "e_video_out",
+      "from_node_id": "op_generate",
+      "from_port_id": "out_0",
+      "to_node_id": "sub_video",
+      "to_port_id": "in",
+      "type": "video"
+    },
+    {
+      "id": "e_report_out",
+      "from_node_id": "op_generate",
+      "from_port_id": "out_1",
+      "to_node_id": "sub_report",
+      "to_port_id": "in",
+      "type": "text"
+    },
+    {
+      "id": "e_refined_out",
+      "from_node_id": "op_generate",
+      "from_port_id": "out_2",
+      "to_node_id": "sub_refined",
+      "to_port_id": "in",
+      "type": "text"
+    }
   ]
-}
+}