generate_scene_images

Generate scene stills

Make the still pictures of the scenes you name. This spends credits and returns as soon as the work is dispatched — poll get_storyboard, and use its show to look at what landed. The board computes a still ORDER and this refuses a scene whose turn has not come, naming what it waits on: a recurring face is anchored by one still first, and then every scene that seats that person can be made at once. Ask for the open wave, look at it, create_subject from the anchor, then the next. Only as many scenes as the plan runs at once go out; the rest come back as remaining scenes for a second call. Pass quote to price the batch against the balance without making anything.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.
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.
Can delete or overwrite: Can delete, overwrite, cancel or withdraw something the caller already has, so a host should confirm it.
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.

This spends credits and returns as soon as the work is dispatched — poll get_storyboard, and use its `show` to look at what landed.

Inputs

storyboard_idstring · required
uuid
scenesarray of integer · required
at least 1 item · at most 30 items
reference_scenesarray of integer · optional
at most 4 items
referencesarray of object (type: "upload") or object (type: "generation") · optional
quoteboolean · optional
idempotency_keystring · optional
at least 1 character · at most 128 characters

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": "generate_scene_images",
    "arguments": {
      "storyboard_id": "00000000-0000-4000-8000-000000000000",
      "scenes": [
        1
      ]
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "storyboard_id": {
      "type": "string",
      "format": "uuid"
    },
    "scenes": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "minItems": 1,
      "maxItems": 30
    },
    "reference_scenes": {
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0
      },
      "maxItems": 4
    },
    "references": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "upload"
              },
              "upload_id": {
                "type": "string",
                "format": "uuid"
              }
            },
            "required": [
              "type",
              "upload_id"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "generation"
              },
              "generation_id": {
                "type": "string",
                "format": "uuid"
              }
            },
            "required": [
              "type",
              "generation_id"
            ],
            "additionalProperties": false
          }
        ]
      }
    },
    "quote": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "storyboard_id",
    "scenes"
  ],
  "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…
create_subject
Name an identity so it can be reused.
create_storyboard
Make a film three ways: from a brief you have written as scenes, from media the account already holds, or from a video you have already analysed.
set_scene_image
Use an image the account already holds — a generation or an upload — as one scene's still, replacing the one it has.
apply_storyboard_template
Make a new storyboard from a template: every scene and connection, unshot.

Every tool· This page as Markdown