Skip to content

Save a look as a preset and call it from an app

Pro

You’ll get: one model name for your house style. Your apps send a prompt, and each image uses the saved model, size and quality. Change the preset later, and every app gets the change.

You need:

  1. Open Image Lab and pick the model under Model or preset, such as FLUX.3 Image Klein.
  2. Click Advanced and set what every image should share. For example:
    • Custom size: 1024x1024
    • Quality: Medium
  3. Under Save as preset, type Product shot in Preset name.
  4. Click Save as preset.

The Save as preset card with Product shot entered as the preset name and the Save as preset button ready

Image Lab says “Preset saved. It’s ready to use in your apps.” Pick Product shot under Model or preset to try it in Image Lab.

  1. Open Use in your apps.
  2. Under Example, pick Product shot.
  3. Copy Model name to send. It’s the preset name with a short code that makes it unique, such as @preset/product-shot-a04e3c.

The Example card with Product shot picked, its model name @preset/product-shot-a04e3c, the note that a preset creates images, and a curl request that uses it

curl http://127.0.0.1:3939/v1/images/generations \
-H "Authorization: Bearer $NEXUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "@preset/product-shot-a04e3c", "prompt": "A walnut cutting board"}' \
| jq -r '.data[0].b64_json' | base64 --decode > image.png

Use your preset’s name in place of @preset/product-shot-a04e3c. The request needs only a prompt: the size and quality come from the preset. A field the app does send, such as size, wins over the preset.

The image comes back at 1024 × 1024. In Image Lab, the preset is listed under Model or preset, and in Presets.

  • Not allowed: the app’s key can’t use the preset. Give it access in API keys.
  • Unknown model: check the name, including the code after product-shot-.

A seed you type in Seed before saving is kept in the preset, and every image starts from it. Leave Seed blank for a new image each time.

The preset creates images. To change an image from an app, send the model’s own name, such as images/flux-3-image-klein-q4. In Image Lab, Change this image works with the preset selected, if your key can also use its model.

Use Image Lab’s Save as preset for image settings. The Describe it and Pick a goal paths in the general preset creator are for language models.

To change the look later, edit the preset in Presets. Apps keep the same name.