render_storyboard

Render a storyboard

Assemble a film's derived videos into MP4s. Name the videos by the number the board prints (Video 1 is 1); omit them to render every video whose clips are all ready. Rendering spends no credits — it takes a job slot against the plan's concurrent-operation limit and the renderer's own budget. It returns immediately: poll get_storyboard until output.render_id matches the accepted render ID and output_current is true. An older URL is not completion.

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.

Rendering spends no credits — it takes a job slot against the plan's concurrent-operation limit and the renderer's own budget.

Inputs

storyboard_idstring · required
uuid
videosarray of integer · optional
at most 20 items

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": "render_storyboard",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "videos": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 20
    }
  },
  "required": [
    "storyboard_id"
  ],
  "additionalProperties": false
}

Related tools

get_storyboard
Read a film: its settings, its cast, every scene by number with its prompts and the state of its still and its clip, each derived video with how many clip…
apply_storyboard_template
Make a new storyboard from a template: every scene and connection, unshot.

Every tool· This page as Markdown