Skip to main content
Glama

get_generations

Read-onlyIdempotent

Get the full record of generations of yours by id: each one's download URL and expiry, promptJSON (the original call, so the generation can be extended or reproduced), its current delivery settings, where its reference images came from, and its parents (the set it extends, or the generations its references were copied from). The ids come from list_recent_generations or from a generation's download URL. Ids that are not found are reported without failing the call, which fails only when none was found. Up to 50 ids per call. Costs no credits.

Input Schema

NameRequiredDescriptionDefault
generationsYesThe ids of the generations to get: the random segment of each one's download URL.

Output Schema

NameRequiredDescriptionDefault
notFoundNoIds that were not found for this API key or whose download window has closed.
generationsYesThe generations found, in the order asked for, each with its full record.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedOutput schema / properties / generations / items / properties / levers / description
      Previous value: -"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."New value: +"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background, and maxKB when a file size limit is set; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."
    • addedOutput schema / properties / generations / items / properties / levers / properties / maxKB
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality, maxKB) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  2. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (an edit that composes a transparent set over a color leaves it transparent here; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (a set generated transparent stays transparent here after an edit changes its background to a color; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  3. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / parents / description
      Previous value: -"Ids of the generations whose delivered images seeded this one's references - the set lineage. Absent when this generation extended nothing."New value: +"Ids of the generations this one came from: for a batch made with an extend tool, its set's first batch; otherwise the generations its sourced references were copied from (create_reference's sourceGeneration). Only a parent made by the same tool on the same kind of background, a color or transparent, is in this one's set; any other only supplied reference images. Absent when neither applies."
  4. Changed12 schema fields changed
    • addedOutput schema / properties / generations / items / properties / crispBaseSize
      Added value: +{
      +  "description": "The largest base size, in pixels, at which export_set keeps every density of this batch crisp (no image enlarged past its source pixels) at its current levers; absent when no base size does. An image or character set's is set by its subject or variation count at generation, and edits to size, canvas, margin or sizing can move it; an illustration set's is a quarter of the longest side its scenes were drawn at, the largest it exports at.",
      +  "type": "integer"
      +}
    • changedOutput schema / properties / generations / items / properties / editable / description
      Previous value: -"True when it can be re-delivered: a set with edit_image_set, an illustration with edit_illustration (each has a source to cut from)."New value: +"True when edit_set can re-deliver it (it has a source to cut from)."
    • changedOutput schema / properties / generations / items / properties / edited / description
      Previous value: -"True when an edit (edit_image_set for a set, edit_illustration for an illustration) has changed its delivery from what was generated; a reset makes it false again."New value: +"True when edit_set has changed its delivery from what was generated; a reset makes it false again."
    • removedOutput schema / properties / generations / items / properties / iconCeiling
      Removed value: -{
      -  "description": "The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Set by the subject count at generation; edits to size, canvas, margin or sizing can move it.",
      -  "type": "integer"
      -}
    • changedOutput schema / properties / generations / items / properties / id / description
      Previous value: -"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, edit_illustration, export_icons and create_reference's sourceGeneration."New value: +"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_set, export_set, extend_image_set, extend_character_set, extend_illustration_set and create_reference's sourceGeneration."
    • removedOutput schema / properties / generations / items / properties / illustrationLevers
      Removed value: -{
      -  "additionalProperties": false,
      -  "description": "The delivery settings now in force for an illustration (width, height, format, quality): the first delivery's until edit_illustration changes them.",
      -  "properties": {
      -    "format": {
      -      "type": "string"
      -    },
      -    "height": {
      -      "type": "integer"
      -    },
      -    "quality": {
      -      "type": "integer"
      -    },
      -    "width": {
      -      "type": "integer"
      -    }
      -  },
      -  "required": [
      -    "width",
      -    "height",
      -    "format"
      -  ],
      -  "type": [
      -    "null",
      -    "object"
      -  ]
      -}
    • changedOutput schema / properties / generations / items / properties / levers / description
      Previous value: -"The delivery levers now in force for a set (width, height, canvas, minimumMargin, sizing, format, quality, background): the first delivery's until edit_image_set changes them. Absent on illustrations and on sets from before editing existed."New value: +"The delivery levers now in force (width, height, canvas, minimumMargin, sizing, format, quality, background; an illustration set has width, height, format and quality): the first delivery's until edit_set changes them. Absent on sets from before editing existed."
    • changedOutput schema / properties / generations / items / properties / levers / properties / minimumMargin / type
      Previous value: -"integer"New value: +[
      +  "null",
      +  "integer"
      +]
    • changedOutput schema / properties / generations / items / properties / levers / required
      Previous value: -[
      -  "minimumMargin",
      -  "format"
      -]New value: +[
      +  "format"
      +]
    • changedOutput schema / properties / generations / items / properties / nativeWidth / description
      Previous value: -"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against. For an illustration, the size the model made it at, the largest it can be delivered at."New value: +"The canvas this set would be delivered on at native size, with no width or height fixed: the size any re-delivery compares against. For an illustration set, the size the model draws its scenes at, the largest they can be delivered at."
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (a set's style, subjects and references; an illustration's prompt and references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, format, quality, background) are the current delivery, which an edit rewrites (edit_image_set for a set, edit_illustration for an illustration's width, height, format and quality), so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places. Illustrations carry prompt, references as zip-relative paths when the call used them, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (the style or character, the list and the references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, sizing, format, quality) are the current delivery, which edit_set rewrites, so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its background is the color the set was generated on, or transparent (an edit that composes a transparent set over a color leaves it transparent here; levers holds the color). Its shape follows the tool named in its own tool field. Image sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background (a color, or transparent), and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places; illustration sets carry style, styleReferences, scenes, width, height, format and quality. Read each entry's description (subjects[], variations[] or scenes[]) to reproduce a set: an entry given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
    • changedOutput schema / properties / generations / items / properties / references / description
      Previous value: -"Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences, characterReferences or references, by tool. Absent when none were used."New value: +"Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences or characterReferences, by tool. Absent when none were used."
  5. Changed3 schema fields changed
    • changedOutput schema / properties / generations / items / properties / parents / description
      Previous value: -"Ids of the generations whose delivered images seeded this one's style references - the set lineage. Absent when this generation extended nothing."New value: +"Ids of the generations whose delivered images seeded this one's references - the set lineage. Absent when this generation extended nothing."
    • addedOutput schema / properties / generations / items / properties / references
      Added value: +{
      +  "description": "Where each reference image this generation was made with came from, in call order: the generation and delivered image it was copied from (what create_reference takes as sourceGeneration and sourceImage), or uploaded for a hand-uploaded file. The same images are inside promptJSON as zip-relative paths, under styleReferences, characterReferences or references, by tool. Absent when none were used.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "from": {
      +        "description": "The generation id this reference image came from; accepted by create_reference's sourceGeneration.",
      +        "type": "string"
      +      },
      +      "image": {
      +        "description": "The delivered image filename inside that generation; accepted by create_reference's sourceImage.",
      +        "type": "string"
      +      },
      +      "uploaded": {
      +        "description": "True for a hand-uploaded reference that came from no generation.",
      +        "type": "boolean"
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": [
      +    "null",
      +    "array"
      +  ]
      +}
    • removedOutput schema / properties / generations / items / properties / styleReferences
      Removed value: -{
      -  "description": "The style references this generation was made with, in call order, each identified by the delivered image it came from when known, and reusable via create_reference. Distinct from promptJSON.styleReferences, which records the same references as zip-relative paths inside the original call. Absent when no references were used.",
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "from": {
      -        "description": "The generation id this reference image came from; accepted by create_reference's sourceGeneration.",
      -        "type": "string"
      -      },
      -      "image": {
      -        "description": "The delivered image filename inside that generation; accepted by create_reference's sourceImage.",
      -        "type": "string"
      -      },
      -      "uploaded": {
      -        "description": "True for a hand-uploaded reference that came from no generation.",
      -        "type": "boolean"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "type": [
      -    "null",
      -    "array"
      -  ]
      -}
  6. Changed7 schema fields changed
    • changedOutput schema / properties / generations / items / properties / deliveredAt / description
      Previous value: -"When the current delivery was cut: the generation time, or the time of the last edit_image_set."New value: +"When the current delivery was cut: the generation time, or the time of the last edit."
    • changedOutput schema / properties / generations / items / properties / editable / description
      Previous value: -"True when this set can be re-delivered with edit_image_set (it has a source to cut from)."New value: +"True when it can be re-delivered: a set with edit_image_set, an illustration with edit_illustration (each has a source to cut from)."
    • changedOutput schema / properties / generations / items / properties / edited / description
      Previous value: -"True when edit_image_set has changed this set's delivery from what was generated; a reset makes it false again."New value: +"True when an edit (edit_image_set for a set, edit_illustration for an illustration) has changed its delivery from what was generated; a reset makes it false again."
    • changedOutput schema / properties / generations / items / properties / id / description
      Previous value: -"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, export_icons and create_reference's sourceGeneration."New value: +"The generation's id: the random segment of its download URLs, accepted by get_generations, delete_generations, edit_image_set, edit_illustration, export_icons and create_reference's sourceGeneration."
    • addedOutput schema / properties / generations / items / properties / illustrationLevers
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "The delivery settings now in force for an illustration (width, height, format, quality): the first delivery's until edit_illustration changes them.",
      +  "properties": {
      +    "format": {
      +      "type": "string"
      +    },
      +    "height": {
      +      "type": "integer"
      +    },
      +    "quality": {
      +      "type": "integer"
      +    },
      +    "width": {
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "width",
      +    "height",
      +    "format"
      +  ],
      +  "type": [
      +    "null",
      +    "object"
      +  ]
      +}
    • changedOutput schema / properties / generations / items / properties / nativeWidth / description
      Previous value: -"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against."New value: +"The canvas this set would be delivered on at native size (its trimmed frame plus margin): the size any re-delivery compares against. For an illustration, the size the model made it at, the largest it can be delivered at."
    • changedOutput schema / properties / generations / items / properties / promptJSON / description
      Previous value: -"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. Its style, subjects and styleReferences are the original call and no edit can change them; its delivery levers (width, height, canvas, minimumMargin, format, quality, background) are the batch's current delivery, which edit_image_set rewrites, so reusing this reproduces the set as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them. Illustrations carry prompt, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."New value: +"The batch's own prompt.json, verbatim - the same bytes that ship inside the zip. What it asked for (a set's style, subjects and references; an illustration's prompt and references) is the original call, and no edit can change it; its delivery settings (width, height, canvas, minimumMargin, format, quality, background) are the current delivery, which an edit rewrites (edit_image_set for a set, edit_illustration for an illustration's width, height, format and quality), so reusing this reproduces the generation as it stands now rather than as first delivered. The edited flag says whether that has happened. Its shape follows the tool named in its own tool field. Sets carry style, subjects as {description, filename} pairs, format, quality, minimumMargin, validation, width and height when an axis was fixed, background for solid-background sets, and styleReferences as zip-relative paths when the call used them; character sets carry character, variations and characterReferences in those places. Illustrations carry prompt, references as zip-relative paths when the call used them, width, height, format, quality and filename. Read subjects[].description to reproduce a set: a subject given in object form has a description that differs from its filename, so search.webp may have been asked for as a magnifying glass."
  7. Changed1 schema field changed
    • changedOutput schema / properties / generations / items / properties / iconCeiling / description
      Previous value: -"The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Fixed by the subject count at generation; edits to margin or sizing move it."New value: +"The largest base size, in pixels, at which export_icons keeps every density of this set crisp (no subject enlarged past its source pixels) at its current levers; absent when no base size does. Set by the subject count at generation; edits to size, canvas, margin or sizing can move it."
  8. Added

TDQS

A4.4/5.0
Behavior5/5

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

Goes well beyond the annotations, which only cover read-only/idempotent/non-destructive. The description discloses partial-failure semantics ('Ids that are not found are reported without failing the call, which fails only when none was found'), a hard batch limit of 50 ids, and that the call costs no credits — all behavioral facts an agent cannot infer from the structured fields.

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-loads the purpose, then adds id provenance, failure semantics, limits, and cost in a logical order. It is a dense run-on paragraph with some nesting, but each sentence carries distinct operational information and none is filler.

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

Completeness5/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 re-explained; the description nonetheless frames them. Combined with the documented error semantics, batch cap, and zero-cost note, an agent has everything needed to call this correctly.

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 coverage is 100% and the schema description already states that each id is 'the random segment of each one's download URL'. The description repeats that mapping and adds the 50-id batch bound, but contributes no further per-parameter syntax or format detail, so the baseline 3 is appropriate.

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+resource ('Get the full record of generations') and enumerates what the record contains: download URL and expiry, promptJSON, delivery settings, reference image provenance, and parents. It also distinguishes itself from the sibling that produces the ids (list_recent_generations), so an agent can tell the two apart without opening either schema.

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?

Explicitly tells the agent where valid ids come from ('list_recent_generations or from a generation's download URL'), which routes it to the correct sibling for discovery. It does not state exclusions or contrast against the other get-style siblings (list_references), but the usage context is clear.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources