add_scene

Add a scene

Add one scene to a film. Absent after_scene appends it to the end of Video 1; 0 puts it first; N splices it right after Scene N on that scene's own video. continue_from_scene gives it the last frame of that scene's clip as its still. Anything left out is filled in: the description and image prompt fall back to the title, an unwritten motion prompt gets a subtle drift, and the length is the film's clip model's usual take. The answer names the number the board gives it, which on a branched board may not be N+1. One undo step; undo_storyboard takes it back. Spends no credits.

Scope

storyboards.write — Authors, edits, renders and deletes storyboards. Reading a board rides media.read, and the two board tools that spend need generation.write as well.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Credits

What the tool's description says about credits, verbatim.

Spends no credits.

Inputs

storyboard_idstring · required
uuid
titlestring · required
at least 1 character · at most 80 characters
descriptionstring · optional
at least 1 character · at most 600 characters
image_promptstring · optional
at least 1 character · at most 2000 characters
motion_promptstring · optional
at least 1 character · at most 6000 characters
duration_secondsnumber · optional
≥ 0.2
hold_motionstring · optional
one of "none", "push_in", "pull_out", "pan_left", "pan_right", "animate"
castarray of string · optional
after_sceneinteger · optional
≥ 0
continue_from_sceneinteger · optional
> 0

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "add_scene",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000",
      "title": "<title>"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "description": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    },
    "image_prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    },
    "motion_prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 6000
    },
    "duration_seconds": {
      "type": "number",
      "minimum": 0.2
    },
    "hold_motion": {
      "type": "string",
      "enum": [
        "none",
        "push_in",
        "pull_out",
        "pan_left",
        "pan_right",
        "animate"
      ]
    },
    "cast": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "after_scene": {
      "type": "integer",
      "minimum": 0
    },
    "continue_from_scene": {
      "type": "integer",
      "exclusiveMinimum": 0
    }
  },
  "required": [
    "storyboard_id",
    "title"
  ],
  "additionalProperties": false
}

Related tools

undo_storyboard
Take back YOUR last gesture on a film, or redo the one you took back.

Every tool· This page as Markdown