Kuro

Edit a storyboard

edit_storyboard

Destructive

Apply an ordered list of edits to a film and get the board back. Scenes are addressed by their 1-based number, and each op resolves its numbers against the board as it stands after the previous one — so "add a scene after 2, then move 5 before it" reads the way you would say it. Consecutive writes share an undo step; another author editing between them starts a separate step. undo_storyboard takes back the latest step, with an origin guard. An op that fails stops the list, the ops before it stand, and the receipt names the one that failed and why — and says so when nothing was written, in which case there is nothing of this call's to undo. Nothing here spends credits. A scene delete is soft and the archive is reversible; media is never destroyed. Use set_scene_clip to attach an existing clip or video upload to a scene, and add_sound to place an existing voice-over or music on the board before rendering. Deleting a scene with one scene before it and one after joins those two, so the video stays whole; deleting one where lines branch or meet leaves its neighbours unconnected, and its receipt says which happened.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`ops`	Yes
`storyboard_id`	Yes

Output Schema

TableJSON Schema

Name	Required	Description	Default
`cast`	Yes
`brief`	Yes
`notes`	Yes
`quote`	No
`texts`	Yes
`scenes`	Yes
`sounds`	Yes
`videos`	Yes
`credits`	Yes
`history`	Yes
`message`	Yes
`skipped`	No
`started`	No
`stopped`	No
`accepted`	No
`receipts`	No
`schedule`	Yes
`settings`	Yes
`reference`	No
`storyboard`	Yes
`download_url`	No
`generation_id`	No
`remaining_scenes`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 21, 2026

changedInput schema / properties / ops / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "cast": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "continue_from_scene": {
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "description": {
-        "maxLength": 600,
-        "minLength": 1,
-        "type": "string"
-      },
-      "duration_seconds": {
-        "minimum": 0.2,
-        "type": "number"
-      },
-      "hold_motion": {
-        "enum": [
-          "none",
-          "push_in",
-          "pull_out",
-          "pan_left",
-          "pan_right",
-          "animate"
-        ],
-        "type": "string"
-      },
-      "image_prompt": {
-        "maxLength": 2000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "motion_prompt": {
-        "maxLength": 1000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene",
-        "type": "string"
-      },
-      "title": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "title",
-      "duration_seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "cast": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
-          },
-          "description": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
-          },
-          "duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
-          },
-          "hold_motion": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
-          },
-          "image_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
-          },
-          "motion_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
-          },
-          "title": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
-          },
-          "video_model": {
-            "anyOf": [
-              {
-                "enum": [
-                  "seedance-2.5",
-                  "seedance-2.5-spicy",
-                  "seedance-2.0",
-                  "seedance-2.0-mini",
-                  "seedance-2.0-fast",
-                  "grok-imagine-video-1.5",
-                  "veo-3.1",
-                  "veo-3.1-fast",
-                  "veo-3.1-lite",
-                  "gemini-omni-1.1",
-                  "kling-v3-omni-video",
-                  "kling-v3-video",
-                  "happyhorse-1.0",
-                  "wan-3",
-                  "wan-3-prime",
-                  "gen-4.5",
-                  "p-video",
-                  "p-video-2",
-                  "flux-3",
-                  "minimax-h3-max",
-                  "p-video-avatar",
-                  "p-video-animate",
-                  "p-video-replace",
-                  "omni-human-1.5",
-                  "kling-avatar-v2",
-                  "kling-v3-motion-control",
-                  "kling-lip-sync",
-                  "sync-lipsync-2",
-                  "genjutsu-motion-transfer",
-                  "genjutsu-object-swap"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "op": {
-        "const": "move_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "after_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "delete_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_image",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_clip",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "render_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "render",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "render_id"
-            ],
-            "type": "object"
-          }
-        ],
-        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "continue_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "from_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "connect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "disconnect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect_ratio": {
-        "enum": [
-          "9:16",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "clip_audio": {
-        "type": "boolean"
-      },
-      "clip_resolution": {
-        "enum": [
-          "360p",
-          "480p",
-          "720p",
-          "768p",
-          "1080p",
-          "4K"
-        ],
-        "type": "string"
-      },
-      "default_image_model": {
-        "enum": [
-          "seedream-5-lite",
-          "nano-banana-2.1",
-          "nano-banana-2",
-          "gpt-image-2.5-flare",
-          "gpt-image-2.5-sunburst",
-          "gpt-image-2",
-          "nano-banana-2-lite",
-          "seedream-5-pro",
-          "seedream-5-pro-spicy",
-          "flux-schnell",
-          "flux-2-flex",
-          "flux-2-pro",
-          "flux-2-max",
-          "recraft-v4.1-svg",
-          "recraft-v4.1-pro-svg",
-          "p-image",
-          "grok-imagine-image",
-          "grok-imagine-image-quality",
-          "krea-3",
-          "qwen-image-3-pro",
-          "soul-2"
-        ],
-        "type": "string"
-      },
-      "default_video_model": {
-        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
-      },
-      "op": {
-        "const": "set_settings",
-        "type": "string"
-      },
-      "style": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "names": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "op": {
-        "const": "set_cast",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "names"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "maxLength": 100,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "rename",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "archived": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "archive",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "archived"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "description": "First scene the card covers. Absent means from the start.",
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "gain_db": {
-        "maximum": 0,
-        "minimum": -40,
-        "type": "integer"
-      },
-      "length": {
-        "enum": [
-          "loop",
-          "once",
-          "in_full"
-        ],
-        "type": "string"
-      },
-      "loop_duration_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "op": {
-        "const": "add_sound",
-        "type": "string"
-      },
-      "reference": {
-        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
-      },
-      "source_in_seconds": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "source_out_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "start_offset_seconds": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "from_scene": {
-            "anyOf": [
-              {
-                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "gain_db": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
-          },
-          "length": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
-          },
-          "loop_duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
-          },
-          "source_in_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
-          },
-          "source_out_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
-          },
-          "start_offset_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_sound",
-        "type": "string"
-      },
-      "sound": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-          },
-          {
-            "format": "uuid",
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "required": [
-      "op",
-      "sound",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_sound",
-        "type": "string"
-      },
-      "sound": {
-        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
-      }
-    },
-    "required": [
-      "op",
-      "sound"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "color": {
-        "enum": [
-          "yellow",
-          "pink",
-          "blue",
-          "green"
-        ],
-        "type": "string"
-      },
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_note",
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 280,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "color": {
-            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
-          },
-          "text": {
-            "maxLength": 280,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "note_id": {
-        "pattern": "^note_[a-z0-9_/-]+$",
-        "type": "string"
-      },
-      "op": {
-        "const": "update_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note_id": {
-        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
-      },
-      "op": {
-        "const": "remove_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_text",
-        "type": "string"
-      },
-      "size": {
-        "enum": [
-          "title",
-          "body"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "size": {
-            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
-          },
-          "text": {
-            "maxLength": 500,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_text",
-        "type": "string"
-      },
-      "text_id": {
-        "pattern": "^text_[a-z0-9_/-]+$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_text",
-        "type": "string"
-      },
-      "text_id": {
-        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
-      }
-    },
-    "required": [
-      "op",
-      "text_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_cover",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "description": {
-        "anyOf": [
-          {
-            "maxLength": 300,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "favorite": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "describe",
-        "type": "string"
-      },
-      "user_tags": {
-        "items": {
-          "maxLength": 40,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "cast": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "continue_from_scene": {
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "description": {
+        "maxLength": 600,
+        "minLength": 1,
+        "type": "string"
+      },
+      "duration_seconds": {
+        "minimum": 0.2,
+        "type": "number"
+      },
+      "hold_motion": {
+        "enum": [
+          "none",
+          "push_in",
+          "pull_out",
+          "pan_left",
+          "pan_right",
+          "animate"
+        ],
+        "type": "string"
+      },
+      "image_prompt": {
+        "maxLength": 2000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "motion_prompt": {
+        "maxLength": 1000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene",
+        "type": "string"
+      },
+      "title": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "title",
+      "duration_seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "auto_duration": {
+            "type": "boolean"
+          },
+          "cast": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
+          },
+          "description": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
+          },
+          "duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
+          },
+          "hold_motion": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
+          },
+          "image_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
+          },
+          "motion_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
+          },
+          "title": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
+          },
+          "video_model": {
+            "anyOf": [
+              {
+                "enum": [
+                  "seedance-2.5",
+                  "seedance-2.5-spicy",
+                  "seedance-2.0",
+                  "seedance-2.0-mini",
+                  "seedance-2.0-fast",
+                  "grok-imagine-video-1.5",
+                  "veo-3.1",
+                  "veo-3.1-fast",
+                  "veo-3.1-lite",
+                  "gemini-omni-1.1",
+                  "kling-v3-omni-video",
+                  "kling-v3-video",
+                  "happyhorse-1.0",
+                  "wan-3",
+                  "wan-3-prime",
+                  "gen-4.5",
+                  "p-video",
+                  "p-video-2",
+                  "flux-3",
+                  "minimax-h3-max",
+                  "p-video-avatar",
+                  "p-video-animate",
+                  "p-video-replace",
+                  "omni-human-1.5",
+                  "kling-avatar-v2",
+                  "kling-v3-motion-control",
+                  "kling-lip-sync",
+                  "sync-lipsync-2",
+                  "genjutsu-motion-transfer",
+                  "genjutsu-object-swap"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "op": {
+        "const": "move_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "after_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "delete_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_image",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_clip",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "render_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "render",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "render_id"
+            ],
+            "type": "object"
+          }
+        ],
+        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "continue_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "from_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "connect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "disconnect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect_ratio": {
+        "enum": [
+          "9:16",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "clip_audio": {
+        "type": "boolean"
+      },
+      "clip_resolution": {
+        "enum": [
+          "360p",
+          "480p",
+          "720p",
+          "768p",
+          "1080p",
+          "4K"
+        ],
+        "type": "string"
+      },
+      "default_image_model": {
+        "enum": [
+          "seedream-5-lite",
+          "nano-banana-2.1",
+          "nano-banana-2",
+          "gpt-image-2.5-flare",
+          "gpt-image-2.5-sunburst",
+          "gpt-image-2",
+          "nano-banana-2-lite",
+          "seedream-5-pro",
+          "seedream-5-pro-spicy",
+          "flux-schnell",
+          "flux-2-flex",
+          "flux-2-pro",
+          "flux-2-max",
+          "recraft-v4.1-svg",
+          "recraft-v4.1-pro-svg",
+          "p-image",
+          "grok-imagine-image",
+          "grok-imagine-image-quality",
+          "krea-3",
+          "qwen-image-3-pro",
+          "soul-2"
+        ],
+        "type": "string"
+      },
+      "default_video_model": {
+        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
+      },
+      "op": {
+        "const": "set_settings",
+        "type": "string"
+      },
+      "style": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "names": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "set_cast",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "names"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "rename",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "archived": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "archive",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "archived"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "description": "First scene the card covers. Absent means from the start.",
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "gain_db": {
+        "maximum": 0,
+        "minimum": -40,
+        "type": "integer"
+      },
+      "length": {
+        "enum": [
+          "loop",
+          "once",
+          "in_full"
+        ],
+        "type": "string"
+      },
+      "loop_duration_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "op": {
+        "const": "add_sound",
+        "type": "string"
+      },
+      "reference": {
+        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
+      },
+      "source_in_seconds": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "source_out_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "start_offset_seconds": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "from_scene": {
+            "anyOf": [
+              {
+                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "gain_db": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
+          },
+          "length": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
+          },
+          "loop_duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
+          },
+          "source_in_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
+          },
+          "source_out_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
+          },
+          "start_offset_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_sound",
+        "type": "string"
+      },
+      "sound": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+          },
+          {
+            "format": "uuid",
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "op",
+      "sound",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_sound",
+        "type": "string"
+      },
+      "sound": {
+        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
+      }
+    },
+    "required": [
+      "op",
+      "sound"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "color": {
+        "enum": [
+          "yellow",
+          "pink",
+          "blue",
+          "green"
+        ],
+        "type": "string"
+      },
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_note",
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 280,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "color": {
+            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
+          },
+          "text": {
+            "maxLength": 280,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "note_id": {
+        "pattern": "^note_[a-z0-9_/-]+$",
+        "type": "string"
+      },
+      "op": {
+        "const": "update_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note_id": {
+        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
+      },
+      "op": {
+        "const": "remove_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_text",
+        "type": "string"
+      },
+      "size": {
+        "enum": [
+          "title",
+          "body"
+        ],
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "size": {
+            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
+          },
+          "text": {
+            "maxLength": 500,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_text",
+        "type": "string"
+      },
+      "text_id": {
+        "pattern": "^text_[a-z0-9_/-]+$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_text",
+        "type": "string"
+      },
+      "text_id": {
+        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
+      }
+    },
+    "required": [
+      "op",
+      "text_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_cover",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "anyOf": [
+          {
+            "maxLength": 300,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "favorite": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "describe",
+        "type": "string"
+      },
+      "user_tags": {
+        "items": {
+          "maxLength": 40,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 19, 2026

changedInput schema / properties / ops / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "cast": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "continue_from_scene": {
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "description": {
-        "maxLength": 600,
-        "minLength": 1,
-        "type": "string"
-      },
-      "duration_seconds": {
-        "minimum": 0.2,
-        "type": "number"
-      },
-      "hold_motion": {
-        "enum": [
-          "none",
-          "push_in",
-          "pull_out",
-          "pan_left",
-          "pan_right",
-          "animate"
-        ],
-        "type": "string"
-      },
-      "image_prompt": {
-        "maxLength": 2000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "motion_prompt": {
-        "maxLength": 1000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene",
-        "type": "string"
-      },
-      "title": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "title",
-      "duration_seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "cast": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
-          },
-          "description": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
-          },
-          "duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
-          },
-          "hold_motion": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
-          },
-          "image_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
-          },
-          "motion_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
-          },
-          "title": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
-          },
-          "video_model": {
-            "anyOf": [
-              {
-                "enum": [
-                  "seedance-2.5",
-                  "seedance-2.5-spicy",
-                  "seedance-2.0",
-                  "seedance-2.0-mini",
-                  "seedance-2.0-fast",
-                  "grok-imagine-video-1.5",
-                  "veo-3.1",
-                  "veo-3.1-fast",
-                  "veo-3.1-lite",
-                  "gemini-omni-1.1",
-                  "kling-v3-omni-video",
-                  "kling-v3-video",
-                  "happyhorse-1.0",
-                  "wan-3",
-                  "wan-3-prime",
-                  "gen-4.5",
-                  "p-video",
-                  "p-video-2",
-                  "flux-3",
-                  "minimax-h3-max",
-                  "p-video-avatar",
-                  "p-video-animate",
-                  "p-video-replace",
-                  "omni-human-1.5",
-                  "kling-avatar-v2",
-                  "kling-v3-motion-control",
-                  "kling-lip-sync",
-                  "sync-lipsync-2",
-                  "genjutsu-motion-transfer",
-                  "genjutsu-object-swap"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "op": {
-        "const": "move_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "after_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "delete_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_image",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_clip",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "render_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "render",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "render_id"
-            ],
-            "type": "object"
-          }
-        ],
-        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "continue_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "from_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "connect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "disconnect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect_ratio": {
-        "enum": [
-          "9:16",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "clip_audio": {
-        "type": "boolean"
-      },
-      "clip_resolution": {
-        "enum": [
-          "360p",
-          "480p",
-          "720p",
-          "768p",
-          "1080p",
-          "4K"
-        ],
-        "type": "string"
-      },
-      "default_image_model": {
-        "enum": [
-          "seedream-5-lite",
-          "nano-banana-2.1",
-          "nano-banana-2",
-          "gpt-image-2.5-flare",
-          "gpt-image-2.5-sunburst",
-          "gpt-image-2",
-          "nano-banana-2-lite",
-          "seedream-5-pro",
-          "seedream-5-pro-spicy",
-          "flux-schnell",
-          "flux-2-flex",
-          "flux-2-pro",
-          "flux-2-max",
-          "recraft-v4.1-svg",
-          "recraft-v4.1-pro-svg",
-          "p-image",
-          "grok-imagine-image",
-          "grok-imagine-image-quality",
-          "krea-3",
-          "qwen-image-3-pro",
-          "soul-2"
-        ],
-        "type": "string"
-      },
-      "default_video_model": {
-        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
-      },
-      "op": {
-        "const": "set_settings",
-        "type": "string"
-      },
-      "style": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "names": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "op": {
-        "const": "set_cast",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "names"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "maxLength": 100,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "rename",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "archived": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "archive",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "archived"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "description": "First scene the card covers. Absent means from the start.",
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "gain_db": {
-        "maximum": 0,
-        "minimum": -40,
-        "type": "integer"
-      },
-      "length": {
-        "enum": [
-          "loop",
-          "once",
-          "in_full"
-        ],
-        "type": "string"
-      },
-      "loop_duration_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "op": {
-        "const": "add_sound",
-        "type": "string"
-      },
-      "reference": {
-        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
-      },
-      "source_in_seconds": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "source_out_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "start_offset_seconds": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "from_scene": {
-            "anyOf": [
-              {
-                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "gain_db": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
-          },
-          "length": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
-          },
-          "loop_duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
-          },
-          "source_in_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
-          },
-          "source_out_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
-          },
-          "start_offset_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_sound",
-        "type": "string"
-      },
-      "sound": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-          },
-          {
-            "format": "uuid",
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "required": [
-      "op",
-      "sound",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_sound",
-        "type": "string"
-      },
-      "sound": {
-        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
-      }
-    },
-    "required": [
-      "op",
-      "sound"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "color": {
-        "enum": [
-          "yellow",
-          "pink",
-          "blue",
-          "green"
-        ],
-        "type": "string"
-      },
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_note",
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 280,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "color": {
-            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
-          },
-          "text": {
-            "maxLength": 280,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "note_id": {
-        "pattern": "^note_[a-z0-9_/-]+$",
-        "type": "string"
-      },
-      "op": {
-        "const": "update_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note_id": {
-        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
-      },
-      "op": {
-        "const": "remove_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_text",
-        "type": "string"
-      },
-      "size": {
-        "enum": [
-          "title",
-          "body"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "size": {
-            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
-          },
-          "text": {
-            "maxLength": 500,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_text",
-        "type": "string"
-      },
-      "text_id": {
-        "pattern": "^text_[a-z0-9_/-]+$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_text",
-        "type": "string"
-      },
-      "text_id": {
-        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
-      }
-    },
-    "required": [
-      "op",
-      "text_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_cover",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "description": {
-        "anyOf": [
-          {
-            "maxLength": 300,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "favorite": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "describe",
-        "type": "string"
-      },
-      "tags": {
-        "items": {
-          "maxLength": 40,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "cast": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "continue_from_scene": {
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "description": {
+        "maxLength": 600,
+        "minLength": 1,
+        "type": "string"
+      },
+      "duration_seconds": {
+        "minimum": 0.2,
+        "type": "number"
+      },
+      "hold_motion": {
+        "enum": [
+          "none",
+          "push_in",
+          "pull_out",
+          "pan_left",
+          "pan_right",
+          "animate"
+        ],
+        "type": "string"
+      },
+      "image_prompt": {
+        "maxLength": 2000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "motion_prompt": {
+        "maxLength": 1000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene",
+        "type": "string"
+      },
+      "title": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "title",
+      "duration_seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "cast": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
+          },
+          "description": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
+          },
+          "duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
+          },
+          "hold_motion": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
+          },
+          "image_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
+          },
+          "motion_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
+          },
+          "title": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
+          },
+          "video_model": {
+            "anyOf": [
+              {
+                "enum": [
+                  "seedance-2.5",
+                  "seedance-2.5-spicy",
+                  "seedance-2.0",
+                  "seedance-2.0-mini",
+                  "seedance-2.0-fast",
+                  "grok-imagine-video-1.5",
+                  "veo-3.1",
+                  "veo-3.1-fast",
+                  "veo-3.1-lite",
+                  "gemini-omni-1.1",
+                  "kling-v3-omni-video",
+                  "kling-v3-video",
+                  "happyhorse-1.0",
+                  "wan-3",
+                  "wan-3-prime",
+                  "gen-4.5",
+                  "p-video",
+                  "p-video-2",
+                  "flux-3",
+                  "minimax-h3-max",
+                  "p-video-avatar",
+                  "p-video-animate",
+                  "p-video-replace",
+                  "omni-human-1.5",
+                  "kling-avatar-v2",
+                  "kling-v3-motion-control",
+                  "kling-lip-sync",
+                  "sync-lipsync-2",
+                  "genjutsu-motion-transfer",
+                  "genjutsu-object-swap"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "op": {
+        "const": "move_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "after_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "delete_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_image",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_clip",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "render_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "render",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "render_id"
+            ],
+            "type": "object"
+          }
+        ],
+        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "continue_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "from_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "connect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "disconnect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect_ratio": {
+        "enum": [
+          "9:16",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "clip_audio": {
+        "type": "boolean"
+      },
+      "clip_resolution": {
+        "enum": [
+          "360p",
+          "480p",
+          "720p",
+          "768p",
+          "1080p",
+          "4K"
+        ],
+        "type": "string"
+      },
+      "default_image_model": {
+        "enum": [
+          "seedream-5-lite",
+          "nano-banana-2.1",
+          "nano-banana-2",
+          "gpt-image-2.5-flare",
+          "gpt-image-2.5-sunburst",
+          "gpt-image-2",
+          "nano-banana-2-lite",
+          "seedream-5-pro",
+          "seedream-5-pro-spicy",
+          "flux-schnell",
+          "flux-2-flex",
+          "flux-2-pro",
+          "flux-2-max",
+          "recraft-v4.1-svg",
+          "recraft-v4.1-pro-svg",
+          "p-image",
+          "grok-imagine-image",
+          "grok-imagine-image-quality",
+          "krea-3",
+          "qwen-image-3-pro",
+          "soul-2"
+        ],
+        "type": "string"
+      },
+      "default_video_model": {
+        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
+      },
+      "op": {
+        "const": "set_settings",
+        "type": "string"
+      },
+      "style": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "names": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "set_cast",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "names"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "rename",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "archived": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "archive",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "archived"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "description": "First scene the card covers. Absent means from the start.",
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "gain_db": {
+        "maximum": 0,
+        "minimum": -40,
+        "type": "integer"
+      },
+      "length": {
+        "enum": [
+          "loop",
+          "once",
+          "in_full"
+        ],
+        "type": "string"
+      },
+      "loop_duration_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "op": {
+        "const": "add_sound",
+        "type": "string"
+      },
+      "reference": {
+        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
+      },
+      "source_in_seconds": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "source_out_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "start_offset_seconds": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "from_scene": {
+            "anyOf": [
+              {
+                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "gain_db": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
+          },
+          "length": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
+          },
+          "loop_duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
+          },
+          "source_in_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
+          },
+          "source_out_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
+          },
+          "start_offset_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_sound",
+        "type": "string"
+      },
+      "sound": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+          },
+          {
+            "format": "uuid",
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "op",
+      "sound",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_sound",
+        "type": "string"
+      },
+      "sound": {
+        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
+      }
+    },
+    "required": [
+      "op",
+      "sound"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "color": {
+        "enum": [
+          "yellow",
+          "pink",
+          "blue",
+          "green"
+        ],
+        "type": "string"
+      },
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_note",
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 280,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "color": {
+            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
+          },
+          "text": {
+            "maxLength": 280,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "note_id": {
+        "pattern": "^note_[a-z0-9_/-]+$",
+        "type": "string"
+      },
+      "op": {
+        "const": "update_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note_id": {
+        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
+      },
+      "op": {
+        "const": "remove_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_text",
+        "type": "string"
+      },
+      "size": {
+        "enum": [
+          "title",
+          "body"
+        ],
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "size": {
+            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
+          },
+          "text": {
+            "maxLength": 500,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_text",
+        "type": "string"
+      },
+      "text_id": {
+        "pattern": "^text_[a-z0-9_/-]+$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_text",
+        "type": "string"
+      },
+      "text_id": {
+        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
+      }
+    },
+    "required": [
+      "op",
+      "text_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_cover",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "anyOf": [
+          {
+            "maxLength": 300,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "favorite": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "describe",
+        "type": "string"
+      },
+      "user_tags": {
+        "items": {
+          "maxLength": 40,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 16, 2026

changedInput schema / properties / ops / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "cast": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "continue_from_scene": {
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "description": {
-        "maxLength": 600,
-        "minLength": 1,
-        "type": "string"
-      },
-      "duration_seconds": {
-        "minimum": 0.2,
-        "type": "number"
-      },
-      "hold_motion": {
-        "enum": [
-          "none",
-          "push_in",
-          "pull_out",
-          "pan_left",
-          "pan_right",
-          "animate"
-        ],
-        "type": "string"
-      },
-      "image_prompt": {
-        "maxLength": 2000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "motion_prompt": {
-        "maxLength": 1000,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "add_scene",
-        "type": "string"
-      },
-      "title": {
-        "maxLength": 80,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "title",
-      "duration_seconds"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "cast": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
-          },
-          "description": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
-          },
-          "duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
-          },
-          "hold_motion": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
-          },
-          "image_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
-          },
-          "motion_prompt": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
-          },
-          "title": {
-            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
-          },
-          "video_model": {
-            "anyOf": [
-              {
-                "enum": [
-                  "seedance-2.5",
-                  "seedance-2.5-spicy",
-                  "seedance-2.0",
-                  "seedance-2.0-mini",
-                  "seedance-2.0-fast",
-                  "grok-imagine-video-1.5",
-                  "veo-3.1",
-                  "veo-3.1-fast",
-                  "veo-3.1-lite",
-                  "gemini-omni-1.1",
-                  "kling-v3-omni-video",
-                  "kling-v3-video",
-                  "happyhorse-1.0",
-                  "wan-3",
-                  "wan-3-prime",
-                  "gen-4.5",
-                  "p-video",
-                  "p-video-2",
-                  "flux-3",
-                  "minimax-h3-max",
-                  "p-video-avatar",
-                  "p-video-animate",
-                  "p-video-replace",
-                  "omni-human-1.5",
-                  "kling-avatar-v2",
-                  "kling-v3-motion-control",
-                  "kling-lip-sync",
-                  "sync-lipsync-2",
-                  "genjutsu-motion-transfer",
-                  "genjutsu-object-swap"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "after_scene": {
-        "minimum": 0,
-        "type": "integer"
-      },
-      "op": {
-        "const": "move_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "after_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "delete_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_image",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_scene_clip",
-        "type": "string"
-      },
-      "reference": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "generation_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "generation",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "generation_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "upload",
-                "type": "string"
-              },
-              "upload_id": {
-                "format": "uuid",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "upload_id"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "render_id": {
-                "format": "uuid",
-                "type": "string"
-              },
-              "type": {
-                "const": "render",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "render_id"
-            ],
-            "type": "object"
-          }
-        ],
-        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "continue_scene",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene",
-      "from_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "connect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      },
-      "op": {
-        "const": "disconnect_scenes",
-        "type": "string"
-      },
-      "to_scene": {
-        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "from_scene",
-      "to_scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "aspect_ratio": {
-        "enum": [
-          "9:16",
-          "1:1",
-          "16:9"
-        ],
-        "type": "string"
-      },
-      "clip_audio": {
-        "type": "boolean"
-      },
-      "clip_resolution": {
-        "enum": [
-          "360p",
-          "480p",
-          "720p",
-          "768p",
-          "1080p",
-          "4K"
-        ],
-        "type": "string"
-      },
-      "default_image_model": {
-        "enum": [
-          "seedream-5-lite",
-          "nano-banana-2.1",
-          "nano-banana-2",
-          "gpt-image-2.5-flare",
-          "gpt-image-2.5-sunburst",
-          "gpt-image-2",
-          "nano-banana-2-lite",
-          "seedream-5-pro",
-          "seedream-5-pro-spicy",
-          "flux-schnell",
-          "flux-2-flex",
-          "flux-2-pro",
-          "flux-2-max",
-          "recraft-v4.1-svg",
-          "recraft-v4.1-pro-svg",
-          "p-image",
-          "grok-imagine-image",
-          "grok-imagine-image-quality",
-          "soul-2"
-        ],
-        "type": "string"
-      },
-      "default_video_model": {
-        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
-      },
-      "op": {
-        "const": "set_settings",
-        "type": "string"
-      },
-      "style": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "names": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "op": {
-        "const": "set_cast",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "names"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "name": {
-        "maxLength": 100,
-        "minLength": 1,
-        "type": "string"
-      },
-      "op": {
-        "const": "rename",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "archived": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "archive",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "archived"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "from_scene": {
-        "description": "First scene the card covers. Absent means from the start.",
-        "exclusiveMinimum": 0,
-        "type": "integer"
-      },
-      "gain_db": {
-        "maximum": 0,
-        "minimum": -40,
-        "type": "integer"
-      },
-      "length": {
-        "enum": [
-          "loop",
-          "once",
-          "in_full"
-        ],
-        "type": "string"
-      },
-      "loop_duration_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "op": {
-        "const": "add_sound",
-        "type": "string"
-      },
-      "reference": {
-        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
-      },
-      "source_in_seconds": {
-        "minimum": 0,
-        "type": "number"
-      },
-      "source_out_seconds": {
-        "anyOf": [
-          {
-            "exclusiveMinimum": 0,
-            "type": "number"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "start_offset_seconds": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "op",
-      "reference"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "from_scene": {
-            "anyOf": [
-              {
-                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "gain_db": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
-          },
-          "length": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
-          },
-          "loop_duration_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
-          },
-          "source_in_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
-          },
-          "source_out_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
-          },
-          "start_offset_seconds": {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_sound",
-        "type": "string"
-      },
-      "sound": {
-        "anyOf": [
-          {
-            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-          },
-          {
-            "format": "uuid",
-            "type": "string"
-          }
-        ]
-      }
-    },
-    "required": [
-      "op",
-      "sound",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_sound",
-        "type": "string"
-      },
-      "sound": {
-        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
-      }
-    },
-    "required": [
-      "op",
-      "sound"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "color": {
-        "enum": [
-          "yellow",
-          "pink",
-          "blue",
-          "green"
-        ],
-        "type": "string"
-      },
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_note",
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 280,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "color": {
-            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
-          },
-          "text": {
-            "maxLength": 280,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "note_id": {
-        "pattern": "^note_[a-z0-9_/-]+$",
-        "type": "string"
-      },
-      "op": {
-        "const": "update_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "note_id": {
-        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
-      },
-      "op": {
-        "const": "remove_note",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "note_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "near_scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      },
-      "op": {
-        "const": "add_text",
-        "type": "string"
-      },
-      "size": {
-        "enum": [
-          "title",
-          "body"
-        ],
-        "type": "string"
-      },
-      "text": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "changes": {
-        "additionalProperties": false,
-        "properties": {
-          "size": {
-            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
-          },
-          "text": {
-            "maxLength": 500,
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "op": {
-        "const": "update_text",
-        "type": "string"
-      },
-      "text_id": {
-        "pattern": "^text_[a-z0-9_/-]+$",
-        "type": "string"
-      }
-    },
-    "required": [
-      "op",
-      "text_id",
-      "changes"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "remove_text",
-        "type": "string"
-      },
-      "text_id": {
-        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
-      }
-    },
-    "required": [
-      "op",
-      "text_id"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "op": {
-        "const": "set_cover",
-        "type": "string"
-      },
-      "scene": {
-        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
-      }
-    },
-    "required": [
-      "op",
-      "scene"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "description": {
-        "anyOf": [
-          {
-            "maxLength": 300,
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "favorite": {
-        "type": "boolean"
-      },
-      "op": {
-        "const": "describe",
-        "type": "string"
-      },
-      "tags": {
-        "items": {
-          "maxLength": 40,
-          "minLength": 1,
-          "type": "string"
-        },
-        "maxItems": 8,
-        "type": "array"
-      }
-    },
-    "required": [
-      "op"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "cast": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "continue_from_scene": {
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "description": {
+        "maxLength": 600,
+        "minLength": 1,
+        "type": "string"
+      },
+      "duration_seconds": {
+        "minimum": 0.2,
+        "type": "number"
+      },
+      "hold_motion": {
+        "enum": [
+          "none",
+          "push_in",
+          "pull_out",
+          "pan_left",
+          "pan_right",
+          "animate"
+        ],
+        "type": "string"
+      },
+      "image_prompt": {
+        "maxLength": 2000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "motion_prompt": {
+        "maxLength": 1000,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "add_scene",
+        "type": "string"
+      },
+      "title": {
+        "maxLength": 80,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "title",
+      "duration_seconds"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "cast": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/cast"
+          },
+          "description": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/description"
+          },
+          "duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/duration_seconds"
+          },
+          "hold_motion": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/hold_motion"
+          },
+          "image_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/image_prompt"
+          },
+          "motion_prompt": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/motion_prompt"
+          },
+          "title": {
+            "$ref": "#/properties/ops/items/anyOf/0/properties/title"
+          },
+          "video_model": {
+            "anyOf": [
+              {
+                "enum": [
+                  "seedance-2.5",
+                  "seedance-2.5-spicy",
+                  "seedance-2.0",
+                  "seedance-2.0-mini",
+                  "seedance-2.0-fast",
+                  "grok-imagine-video-1.5",
+                  "veo-3.1",
+                  "veo-3.1-fast",
+                  "veo-3.1-lite",
+                  "gemini-omni-1.1",
+                  "kling-v3-omni-video",
+                  "kling-v3-video",
+                  "happyhorse-1.0",
+                  "wan-3",
+                  "wan-3-prime",
+                  "gen-4.5",
+                  "p-video",
+                  "p-video-2",
+                  "flux-3",
+                  "minimax-h3-max",
+                  "p-video-avatar",
+                  "p-video-animate",
+                  "p-video-replace",
+                  "omni-human-1.5",
+                  "kling-avatar-v2",
+                  "kling-v3-motion-control",
+                  "kling-lip-sync",
+                  "sync-lipsync-2",
+                  "genjutsu-motion-transfer",
+                  "genjutsu-object-swap"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "after_scene": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "op": {
+        "const": "move_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "after_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "delete_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_image",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_scene_clip",
+        "type": "string"
+      },
+      "reference": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "generation_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "generation",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "generation_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "upload",
+                "type": "string"
+              },
+              "upload_id": {
+                "format": "uuid",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "upload_id"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "render_id": {
+                "format": "uuid",
+                "type": "string"
+              },
+              "type": {
+                "const": "render",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "render_id"
+            ],
+            "type": "object"
+          }
+        ],
+        "description": "An owned ready clip generation, verified video upload, or finished storyboard render. Attaches existing footage without generating anything; the scene keeps its still."
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "continue_scene",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene",
+      "from_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "connect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      },
+      "op": {
+        "const": "disconnect_scenes",
+        "type": "string"
+      },
+      "to_scene": {
+        "$ref": "#/properties/ops/items/anyOf/0/properties/continue_from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "from_scene",
+      "to_scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "aspect_ratio": {
+        "enum": [
+          "9:16",
+          "1:1",
+          "16:9"
+        ],
+        "type": "string"
+      },
+      "clip_audio": {
+        "type": "boolean"
+      },
+      "clip_resolution": {
+        "enum": [
+          "360p",
+          "480p",
+          "720p",
+          "768p",
+          "1080p",
+          "4K"
+        ],
+        "type": "string"
+      },
+      "default_image_model": {
+        "enum": [
+          "seedream-5-lite",
+          "nano-banana-2.1",
+          "nano-banana-2",
+          "gpt-image-2.5-flare",
+          "gpt-image-2.5-sunburst",
+          "gpt-image-2",
+          "nano-banana-2-lite",
+          "seedream-5-pro",
+          "seedream-5-pro-spicy",
+          "flux-schnell",
+          "flux-2-flex",
+          "flux-2-pro",
+          "flux-2-max",
+          "recraft-v4.1-svg",
+          "recraft-v4.1-pro-svg",
+          "p-image",
+          "grok-imagine-image",
+          "grok-imagine-image-quality",
+          "krea-3",
+          "qwen-image-3-pro",
+          "soul-2"
+        ],
+        "type": "string"
+      },
+      "default_video_model": {
+        "$ref": "#/properties/ops/items/anyOf/1/properties/changes/properties/video_model/anyOf/0"
+      },
+      "op": {
+        "const": "set_settings",
+        "type": "string"
+      },
+      "style": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "names": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "op": {
+        "const": "set_cast",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "names"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "maxLength": 100,
+        "minLength": 1,
+        "type": "string"
+      },
+      "op": {
+        "const": "rename",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "archived": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "archive",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "archived"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "from_scene": {
+        "description": "First scene the card covers. Absent means from the start.",
+        "exclusiveMinimum": 0,
+        "type": "integer"
+      },
+      "gain_db": {
+        "maximum": 0,
+        "minimum": -40,
+        "type": "integer"
+      },
+      "length": {
+        "enum": [
+          "loop",
+          "once",
+          "in_full"
+        ],
+        "type": "string"
+      },
+      "loop_duration_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "op": {
+        "const": "add_sound",
+        "type": "string"
+      },
+      "reference": {
+        "$ref": "#/properties/ops/items/anyOf/4/properties/reference"
+      },
+      "source_in_seconds": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "source_out_seconds": {
+        "anyOf": [
+          {
+            "exclusiveMinimum": 0,
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "start_offset_seconds": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "op",
+      "reference"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "from_scene": {
+            "anyOf": [
+              {
+                "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "gain_db": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/gain_db"
+          },
+          "length": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/length"
+          },
+          "loop_duration_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/loop_duration_seconds"
+          },
+          "source_in_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_in_seconds"
+          },
+          "source_out_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/source_out_seconds"
+          },
+          "start_offset_seconds": {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/start_offset_seconds"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_sound",
+        "type": "string"
+      },
+      "sound": {
+        "anyOf": [
+          {
+            "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+          },
+          {
+            "format": "uuid",
+            "type": "string"
+          }
+        ]
+      }
+    },
+    "required": [
+      "op",
+      "sound",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_sound",
+        "type": "string"
+      },
+      "sound": {
+        "$ref": "#/properties/ops/items/anyOf/14/properties/sound"
+      }
+    },
+    "required": [
+      "op",
+      "sound"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "color": {
+        "enum": [
+          "yellow",
+          "pink",
+          "blue",
+          "green"
+        ],
+        "type": "string"
+      },
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_note",
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 280,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "color": {
+            "$ref": "#/properties/ops/items/anyOf/16/properties/color"
+          },
+          "text": {
+            "maxLength": 280,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "note_id": {
+        "pattern": "^note_[a-z0-9_/-]+$",
+        "type": "string"
+      },
+      "op": {
+        "const": "update_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "note_id": {
+        "$ref": "#/properties/ops/items/anyOf/17/properties/note_id"
+      },
+      "op": {
+        "const": "remove_note",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "note_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "near_scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      },
+      "op": {
+        "const": "add_text",
+        "type": "string"
+      },
+      "size": {
+        "enum": [
+          "title",
+          "body"
+        ],
+        "type": "string"
+      },
+      "text": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "changes": {
+        "additionalProperties": false,
+        "properties": {
+          "size": {
+            "$ref": "#/properties/ops/items/anyOf/19/properties/size"
+          },
+          "text": {
+            "maxLength": 500,
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "op": {
+        "const": "update_text",
+        "type": "string"
+      },
+      "text_id": {
+        "pattern": "^text_[a-z0-9_/-]+$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "op",
+      "text_id",
+      "changes"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "remove_text",
+        "type": "string"
+      },
+      "text_id": {
+        "$ref": "#/properties/ops/items/anyOf/20/properties/text_id"
+      }
+    },
+    "required": [
+      "op",
+      "text_id"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "op": {
+        "const": "set_cover",
+        "type": "string"
+      },
+      "scene": {
+        "$ref": "#/properties/ops/items/anyOf/13/properties/from_scene"
+      }
+    },
+    "required": [
+      "op",
+      "scene"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "description": {
+        "anyOf": [
+          {
+            "maxLength": 300,
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "favorite": {
+        "type": "boolean"
+      },
+      "op": {
+        "const": "describe",
+        "type": "string"
+      },
+      "tags": {
+        "items": {
+          "maxLength": 40,
+          "minLength": 1,
+          "type": "string"
+        },
+        "maxItems": 8,
+        "type": "array"
+      }
+    },
+    "required": [
+      "op"
+    ],
+    "type": "object"
+  }
+]

First observedOct 15, 2026

TDQS

A4.3/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds substantial behavior beyond the annotations: sequential op resolution against the evolving board, shared undo-step grouping for consecutive writes, origin-guarded undo, fail-fast semantics where prior ops stand and the receipt names the failing op, and the soft/reversible delete guarantee. It also clarifies that a failed batch may write nothing and therefore leaves nothing to undo.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the ordered-list and numbering semantics, then behavior, then edge cases, which is the right order for this tool. It is dense and some sentences are run-on, but given 25 ops and 0% schema description coverage the length is largely earned.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values need not be explained, and the description still usefully describes the failure 'receipt'. For a high-complexity mutation tool it covers ordering, undo, error, credits, and delete-join semantics, though the op catalogue itself is left entirely to the schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the schema defines ~25 op variants, so the description cannot document the fields. It does add the single most important semantic — scenes are addressed by 1-based number and each op resolves numbers against the board as it stands after the previous one — which the schema does not convey. The per-op fields and reference types remain undocumented outside the schema, so this is baseline-plus rather than complete.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource — 'Apply an ordered list of edits to a film and get the board back' — and the scope is unambiguous. It implicitly separates this tool from read/render siblings by describing the mutation semantics and by naming undo_storyboard as the reversal path.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear context: nothing spends credits, ops like set_scene_clip and add_sound are for attaching existing media 'before rendering', and undo_storyboard takes back the latest step. It stops short of explicit when-not conditions or naming a sibling (e.g. render_storyboard) as the alternative, so it is strong but not fully routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Kuro tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?