Skip to content

Use a cloud image provider

Pro

You’ll get: a provider’s image models in Image Lab and in your apps, through Nexus. Your apps use a Nexus key and never see the provider’s key. Use this when your computer can’t run local images, when you need a model only a provider has, or on the Free plan, where only cloud image models work.

You need:

  • For Image Lab, a Pro or Enterprise plan. On Free, Image Lab is locked, but your apps can still call the provider’s image models through Nexus. See Plans.
  • An account and API key with a provider that has image models, such as OpenAI.
  • A client API key for Image Lab and your apps. Make one in API keys.
  1. Open Providers and click Add provider.
  2. Pick the Provider type, such as OpenAI.
  3. Give it a Name, and paste the provider’s API key under Credential.
  4. Save, then click Check connection.

The provider’s models appear in Models after a short sync. More in Providers.

On a new machine, Image Lab also offers this path: under With a provider, click Connect a provider.

  1. Open Image Lab and click the refresh button next to Model or preset.
  2. Pick the provider’s image model.
  3. Type a prompt and click Generate.

If the model doesn’t show, the key in the prompt box can’t use it. Give the key access in API keys, or check the provider shares the model under Models shared with apps.

  • Settings. Each model has its own. Image Lab shows supported Size, Quality, Aspect ratio or Resolution choices, including when you use a preset. Advanced does not add local controls that the model cannot use. Click Reset settings to return to model defaults or the preset’s saved values.
  • No live preview. The image shows when it’s done.
  • Stop waiting. The provider may still finish the image, and still charge for it.
  • Changes. Change this image and Use as a guide show only if the model can change images. Reference-image limits depend on the model.

Use the provider model’s name in the same request as for a local model. Use in your apps shows the name to send. The provider’s key stays in Nexus.

How it was made shows the provider’s model under Model, and the request shows in Activity.