generationstringrequiredThe id of the set to edit: the random segment of its download URL, as list_recent_generations returns it. One batch of a set per call.
Logospell · Docs
Edit set tool
A set you already generated, delivered again at a different size, margin, sizing, file type, quality, or, for a character set or a transparent image set, on another background (any color, or transparent): edit_set re-cuts it from its full-resolution source. Free to call.
01 / 01 · How it works
The delivery tool
edit_set
Change how a set is delivered without spending a credit or getting different pictures. The new delivery replaces the old one at the same download URL. Parameters you leave out keep their current values, so a call can change just one thing, and going back to any earlier version takes one call (reset returns to the original). Image, character and illustration sets alike, but not a set generated before its source was kept. What the pictures show (the style, subjects, variations, scenes and references) cannot be edited: a different picture is a new set.
An illustration set changes only its size, file type and quality. Its width and height go together and must be one of the batch's own sizes: the size its scenes were drawn at (nativeWidth and nativeHeight in get_generations) or an exact half, quarter and so on of it, down to 256 pixels on the shorter side. At that native size, in the model's own format, the originals themselves are delivered.
edit_set
# Deliver an existing set as a 512 x 512 WebP instead
edit_set(
generation: "8a617b9dd9cf51bed87878cc",
width: 512,
height: 512,
format: "webp",
quality: 85
)
# Change the set's background to a dark color, then back to transparent
edit_set(generation: "8a617b9dd9cf51bed87878cc", background: "#111318")
edit_set(generation: "8a617b9dd9cf51bed87878cc", background: "transparent")
# Back to the set exactly as it was generated
edit_set(generation: "8a617b9dd9cf51bed87878cc", reset: true)Or, in plain language to your AI:
ask
Use Logospell to deliver my last transparent image set again as 512 by 512 WebP at quality 85, then once more composed over #111318.resetbooleanoptionaltrue restores every lever to the first delivery, the set as it was generated. Any other lever given in the same call applies on top of that.
widthintegeroptionalImage and character sets: new delivered width, 256 to 512, or 0 to stop fixing the width. Combines with height exactly as on the set tools: both fixed is an exact box, one fixed lets the other hug each subject, neither is native size. On an illustration set, width and height go together, as one of its own sizes (above).
heightintegeroptionalImage and character sets: new delivered height, 256 to 512, or 0 to stop fixing the height. On an illustration set, given together with width.
canvasstringoptionalImage and character sets only. With neither width nor height fixed, what the images land on: uniform (the default) puts the whole set on one canvas, the size it was generated at, every image alike; subject wraps each image around its own subject, so the images differ in size the way the subjects do. Says nothing when a size is fixed.
minimumMarginintegeroptionalImage and character sets only. New minimum margin in pixels around each subject: 0 or more, at most 15% of the smallest fixed side, or at most 80 when no size is fixed. Checked against the width and height in force after the call, so shrinking the box can push a kept margin over the limit.
formatstringoptionalpng, webp, or jpg. jpg has no alpha: on a set delivered transparent it composes the images over white when no background color is in force, and white then stays the set's background until changed. A color given in the same call, or kept from an earlier edit, is used instead.
qualityintegeroptional1 to 100 for webp and jpg; ignored for png. A set with no quality (a png set moved to webp or jpg) gets 90.
maxKBintegeroptionalImage and character sets, webp only. A file size limit for each image, in KB (1 KB = 1024 bytes), 10 to 10240: each image is encoded under it as on the set tools, its quality and the precision of its transparent edges lowered together only where needed, down to quality 70; a set below 70 keeps its quality and lowers only its edges. An image still over the limit is named in the result. 0 removes the limit. A set with a limit refuses a move to png or jpg unless the same call gives 0.
backgroundstringoptionalCharacter sets and transparent image sets only: a #RRGGBB color composes every image over it and delivers an opaque set; "transparent" delivers the images with their alpha, and is rejected while the format is or becomes jpg. Rejected on an image set generated on a color, whose color is in its pixels, and on an illustration set.
sizingstringoptionalImage and character sets only. relative keeps the sizes the model gave the subjects in relation to one another (one scale for the set); fill scales each subject on its own to fill the frame less the margin, so every image reads at the same visual weight, at the cost of relative size and of enlarging subjects smaller than the frame (the result reports by how much).
What comes back
generationstringThe id of the set that was edited.
zipURLstringThe set's download URL, unchanged, now serving the new delivery.
expiresAtstringWhen the download expires. An edit leaves it where it was.
deliveredAtstringWhen this delivery was cut.
widthintegerThe delivered canvas width in pixels; absent when the images differ in width.
heightintegerThe delivered canvas height in pixels; absent when the images differ in height.
leversobjectThe levers now in force: width, height, canvas, minimumMargin, sizing, format, quality, background; a lever at its default (an unfixed axis, uniform canvas, relative sizing) is absent. An illustration set's are only width, height, format and quality.
imagesarrayEach image's filename, the subject, variation or scene it was made from (description), its pixel width and height, and the file's size in bytes. Under a file size limit (maxKB) each also carries the quality it was delivered at, the transparency levels it kept (maskLevels, 256 when exact), and overBudget when it is still over the limit.
crispBaseSizeintegerThe largest base size at which export_set keeps every density of the set crisp at these levers; absent when none does. For an illustration set, a quarter of the longest side its scenes were drawn at, and the largest it exports at.
See each on the site: resize (both sides or one side), fill, margins, canvas, file type and quality, background color, undo (whole set or one batch), and editing the whole set at once.