get_generation

Get generation

Get current status and signed media URL for one generation. A generate tool answers with a quick image already finished and with anything slower at once. For a row still queued or generating, call this once: it waits up to 40 seconds and answers the moment the generation is ready or failed. Call it again only while the status is still queued or generating; ready_in_seconds says roughly how long is left. wait_seconds: 0 reads the status without waiting. include adds detail the plain read leaves out: attempts — every attempt behind a retried row, newest first — and members, the generations inside a group (refused on a row that is not a group).

Scope

media.read — Reads the account: media, uploads, boards, runs, Subjects, models and the balance.

Behaviour

Read-only: Reads the caller's own account and changes nothing.
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.
Idempotent: Calling it again with the same arguments has no further effect.

Inputs

generation_idstring · required
uuid
wait_secondsinteger · optional
≥ 0 · ≤ 40
includearray of string · optional
at most 2 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": "get_generation",
    "arguments": {
      "generation_id": "00000000-0000-4000-8000-000000000000"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "generation_id": {
      "type": "string",
      "format": "uuid"
    },
    "wait_seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 40
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "attempts",
          "members"
        ]
      },
      "maxItems": 2
    }
  },
  "required": [
    "generation_id"
  ],
  "additionalProperties": false
}

Related tools

generate_image
Make an image in the user's Kuro account.
loop_video
Rotate one to three owned 1–15 second video takes to a target duration, up to 30 minutes.
vectorize_image
Convert a raster image — a logo, icon, or flat illustration — into crisp vector paths you can scale to any size without blur.
remove_image_background
Automatically remove the background from product shots, portraits, and generated images.
upscale_image
Crisp Upscale increases resolution and clarity, making an image sharper on screen and ready for print.
restore_photo
Restore an old or damaged photo with FLUX Kontext — fix scratches, repair damage, and bring faded color back to life.
extract_video_frame
Save the first or last decoded frame of an owned video as a new image generation.
trim_video
Save one stretch of an owned video as a new clip, using a keyframe copy by default.

Every tool· This page as Markdown