Skip to main content

Addons and runs

An Addon is one AI task, such as placing a product in a lifestyle scene or creating a product video. It defines its inputs, displayed credit price and outputs. The same Addon can be used in the web app or by a connected AI assistant.

A run is one execution of an Addon with a particular set of inputs. It has its own URL and ID. Editing the composer does not edit that run; selecting Generate starts another one.

Steps and previews​

A run can have several steps, some working at the same time. The run page shows the steps the Addon names and their current state. Progress describes what is happening; it is not an estimate of remaining time.

Some steps expose previews before the run finishes. A preview belongs to that run. Final files appear in the media library only after the whole run succeeds.

Inputs and results​

A run keeps the inputs it started with, so reopening its URL shows the same inputs and results. Files are stored as immutable versions; download links are temporary and can be refreshed by reopening the run or library.

Jobs lists runs that are currently working. It is not a history of finished runs. Keep a run's URL when you want to return to it later.

The public API can start runs and batches, follow them and read their outputs, and redo finished results with a note. It cannot list the runs that are working right now; list the account's runs, newest first, instead.

Next​