Skip to main content
Works with Personal and Team keys. Use variations to get several versions of one object (finishes, colors, sizes) for domain randomization without writing a prompt for each.

Request variations

Variations keep your original asset and save extra versions of it as separate assets in your library. Each variation is a full sim-ready asset with its own collisions and exports. Turn them on with appearance_variants:

Choose a mode

Set variant_mode yourself when calling the API. If your guidance asks for a different size or shape, use geometry or both; in appearance mode, shape requests in the guidance are ignored. The Gizmo home page does this for you: when you type variation guidance there, it reads the guidance to choose the mode, and falls back to a keyword check if that step is unavailable, so generation always starts.

Get the variations

Each variation is delivered on its own as soon as it is ready, so some can finish before others. When the job is done, job.variant_assets lists each variation with its index, name, status and originalAssetId. A ready variation also has an assetId you can export like any other asset. The original stays at result.asset.id. A variation that fails does not fail the original. Batch items (Personal and Team) accept the same fields inside their input object.

Pricing

On Personal accounts each delivered variation costs a flat $1, on top of the original's metered price. Variations that fail are not charged. To start, a request needs $1 plus $1 per requested variation available: an original with 4 variations needs $5. Team variation pricing follows the Team’s configured price. See Billing & limits for details.