Generating images
Each section below is one way a picture is made or added, or one setting that shapes it.
A picture for a file
Generates a new picture onto one of a file's image fields: to make one, click the picture slot and pick Generate with AI.
- The finished image object holds the picture's
urland the prompt it came from. Until it lands, the app shows a spinner on the field. - The picture is kept in the Studio as well as on the file.
- A failed generation leaves
generation.statusaserror, with the reason ingeneration.error, and the field's other keys untouched. - The project's art direction and the type's style are added to the prompt (style instructions).
Pictures on their own
A picture not tied to a file, such as concept art or a gallery item. It is stored in the Studio, and its URL can go on any image field later.
To make one, generate it in the Studio. Pictures made in the Studio can be picked from any picture slot later.
Uploads
Adds a picture someone already has: click the picture slot and pick Upload, or Add from Studio for art you already made in Craft. Uploads cost nothing. Craft reads the file's bytes, not its name: GIF, PNG, JPEG and WebP are accepted, and an animated one is stored as a video with a still (image fields). Upload only art you made, owns or asked for.
Style instructions
Text added to the start of every generated picture's prompt, so a world keeps one look. Two layers:
- The project's art direction, for every picture in the world (project settings).
- A file type's style instructions, added after it for that type's files, in the file type's settings, under Image Style Instructions, or for every type at once in the project's Settings → Image Generation.
Each is at most 5,000 characters; the rest is cut. A game has its own copy of the art direction, taken from its world when it starts.
Reference images
A file type can hold a reference image, a picture whose art style (not its subject) every generation for its files copies. A location type can hold a second one for its map backgrounds. Both live in the file type's settings, under Reference image (and Map background reference image for a location type). Only image models with an edit mode can use a reference. A location type's style instructions style its maps as well as its pictures, so a look meant for maps only belongs in its map reference image (a map's look). When the GM makes a picture in play and the type has no reference, it copies the style of a similar file's picture.
Writing the prompt
A prompt says what the picture shows. Up to 5,000 characters are kept, but a good one is under 100 words.
- Subject first: who or what. "A broad-shouldered dwarf smith".
- Then the moment: pose, action, setting, framing. "Hammering a glowing blade at the forge, chest-up".
- Details from the file: what it says about how they look.
- Leave style out when the world has stored style; light and mood belong in a prompt only when they are about this picture.
- No commentary. The prompt is used as it is written.
Expressions and cutouts
Expression portraits and cutouts are generated onto a character's picture from its main portrait, priced per picture rather than per model: expressions.
To generate expressions, open the character, click View assets on its Expressions & Cutouts card, and click Generate Expressions. For cutouts, use Create cutout in the picture's settings for the portrait, or Generate Cutouts in the character's View assets gallery for its expressions.
Pictures the GM makes
During play the GM gives new files pictures, maps for new places, and faces for the people in a scene. The player's image bank switch decides whether these are free from the bank or drawn on the player's model (the image bank). With the bank off, the player's image generation switch turns them off altogether.
Limits
- Prompts: 5,000 characters.
- Style instructions: 5,000 characters per layer.
- Expressions: 16 per character type.
- Through the CLI: 50 generated pictures per rolling 24 hours across every project, and as many again for expressions and cutouts; 3 reference images a generation; uploads up to 10 MB each, 50 per 24 hours (1,000 with a subscription). Generating through the CLI is off until the account allows it.
Cost
Generating spends energy by default. To spend credits instead, switch the generate dialog, or the chat, to credits. Each surface and model has its own price (energy and credits). A batch is checked against the balance before it starts, and failed pictures are not charged. Uploads are free.