Style studies
A style study tries the same few subjects in two or three styles side by side, before you request real art. Put Maren, a location and a card in living_comic and in cartoon, keep the tiles that work, look at them in a card frame or under a dialogue box, then pick one style to become the project's style guide. Nothing in a study goes through approval or review, nothing is published, and tiles never count against your plan's assets.
Studies come with Supporter and up. On Supporter you upload your own sketches and tests. On Pro, Team and Enterprise, Asset Goes Here can also make quick drafts for images and writing with the project's own OpenAI account.
Start a study
Admins and developers open Style studies and choose New study. A study has:
- An area: images, writing, audio or models. Writing studies hold lines of text; the others hold files.
- Two to four styles. Name one after an existing style guide, such as
living_comic, and the study copies that guide's words and notes for the area. Its column shows the guide's version, such asv3, until you change its words here, when it showsdraft. A new style needs its words, such as "Simple bright cartoon, thick round outlines, flat colour". - Up to eight subjects, such as "Maren" with the note "Character, bust". A subject can name a Library asset, such as
comic.maren.bust, so picking a style can redraw it.
Fill it in
Each cell is one subject in one style. Admins, developers and artists add tries to it:
- Upload an image, audio clip or model into the cell (up to 25 MB each). Images take PNG, JPEG, WebP or GIF; audio MP3, Ogg, WAV, FLAC or M4A; models GLB or a turntable video or still.
- Write a line in a writing study's cell.
- Generate drafts (Pro and up, images and writing only). The bar under the grid offers drafts for the empty cells, or two more of each kept tile once every cell has one, and shows the cost first: about $0.03 an image and well under a cent a line, billed to the project's OpenAI account. An admin connects that account under Settings › Connectors › OpenAI. Drafts are made in the background, one at a time, and appear as they arrive. Asset Goes Here asks for low-quality square images, so they are quick and cheap; a draft shows the style, not a finished asset.
Each tile has Keep and Drop. Kept tiles are the ones that work; dropped ones fade so the rest stand out. Delete removes a tile and its file.
Compare
- Grid shows every subject in every style.
- A/B shows one subject full size in two styles. Press space, or tap the image, to flip between them.
- In context puts each style's kept tiles where they will be seen: image tiles in a card frame and behind a dialogue box, writing tiles as card text, a dialogue line and a button label with its length.
Pick a style
Pick this style on a column makes it a style guide:
- The study's words and notes for that style become the guide's section for the study's area. A style that wasn't a guide yet becomes one at version 1; a guide whose words changed in the study gets its next version.
- Use kept tiles as samples adds the style's kept tiles to the section as samples: lines of text for writing, files for the rest. The guide keeps its own copies, so deleting the study later leaves them.
- Make it the project default makes new requests that name no style use it.
- Redraw lists the study's subjects that name a Library asset, and the assets made in the study's other styles. Each one you tick moves to the picked style: one with a file gets a revision asked for, with the note "Redo in cartoon v1", and an open request just changes style. These are ordinary requests: they go through review and count toward your plan like any other.
The study stays, with the style it picked, until you delete it.
Agents
On the Pro, Team and Enterprise plans, a coding agent connected to Asset Goes Here can run a study for you. Ask it something like "set up four takes between cartoon and crosshatch on Maren, the hall and the Ember Ward card". It starts the study with start_study, fills it with tries it made itself (start_study_upload and add_study_tile), and drafts with your OpenAI account through draft_study. Called without dollars, draft_study only returns the estimate, so the agent tells you the cost and starts the drafts only after you agree. The study then shows up under Style studies for you to compare.
An agent works only on the studies it started. Keeping, dropping and picking stay with people. list_studies, get_study and get_study_tile let it read the board, for example to see which tiles you kept.
Limits
A project has up to 30 studies, a study up to 100 tiles, and a project's studies up to 1 GB of files between them. Drafts are made 24 at a time at most, one job per study at once.
API
| Route | Who | What |
|---|---|---|
GET /projects/{id}/studies | members but fulfillers | Every study, and what the plan allows (access). |
GET /projects/{id}/studies/{study} | members but fulfillers | One study with its styles, subjects, tiles and drafting job. |
PUT /projects/{id}/studies/{study} | admins, developers, agents (their own, Pro and up) | Creates or changes a study: name, area, description, styles (each key, description, prompt, do, dont) and subjects (each key, name, note, asset). |
DELETE /projects/{id}/studies/{study} | admins, developers | Deletes a study and its files. |
POST /projects/{id}/studies/{study}/uploads | admins, developers, artists, agents (their own) | Starts an upload: contentType, size. |
POST /projects/{id}/studies/{study}/tiles | admins, developers, artists, agents (their own) | Adds a tile: subject, style, and uploadId with fileName and contentType, or text. |
PUT /projects/{id}/studies/{study}/tiles/{tile} | admins, developers, artists | Sets state: draft, kept or dropped. |
DELETE /projects/{id}/studies/{study}/tiles/{tile} | admins, developers, artists | Deletes a tile. |
GET /projects/{id}/studies/{study}/tiles/{tile}/file | members but fulfillers | A link to a tile's file. |
POST /projects/{id}/studies/{study}/estimate | members but fulfillers | What drafting cells (each subject, style, count) would cost. |
POST /projects/{id}/studies/{study}/drafts | admins, developers, agents (their own) | Starts drafting cells; dollars is the estimate you confirmed. |
POST /projects/{id}/studies/{study}/pick | admins, developers | Picks style, with default, useKept, restyle (asset ids) and attachKept. |
To redraw images you already have in another style, see Restyle.
For agents: this page as Markdown is at /docs/style-studies.md, and the CLI prints it with agh guide style-studies.