Gen UI Image

Create a UI image with AI-generated content in Unity.

System Requirements

Unity 2022.3 or later.

Installation

1. Copy Git URL;
2. In Unity, open Window > Package Manager;
3. Click on the + icon in the top left corner and select Add package from git URL;

AI Providers

Right now, Gen UI Image supports only OpenAI API.

Available OpenAI Models:

• dall-e-2
• dall-e-3
• gpt-image-1

How to get API Key

GenUIImage needs your API Key to get access to OpenAI generative models. To get the API key:

1. Go to your OpenAI Account
2. In Settings find API Keys.
3. Click Create new secret key and set it up. Copy it.

More information you can find on OpenAI's official guide.

How to add API Key to Gen UI Image

1. In Unity, open Tools > Gen UI Image > Settings.
2. Paste your key in the field.
3. Save it.

How to create Gen UI Image

1. Select Canvas and Right Mouse Click to call the context menu.
2. Select UI > Gen UI Image.
3. Enter your prompt and click Generate.

How to save a generated image

After an image is generated, you will see a Save as Asset button. Click and the image will be saved there Assets/Volorf/Gen UI Image/Generated Images.

How to use Gen UI Image in builds

By default API Key is stored locally on your computer with PlayerPrefs. To carry on this information to your builds you need to do following:

1. Add a ApiKeysProvider component to your Gen UI Image.
2. Open the context menu and select Create > Gen UI Image > Create ApiKeysProviderData. It will create a data asset.
3. Add your API key to the asset.
4. Drag and drop the asset to the ApiKeysProvider component.

How to update Gen UI Image in runtime

Just call the Generate() method in your GenUIImage instance.
You can also specify some of the parameters before the call.
Here is an example:

_genUiImage.model = Model.GptImage1;
_genUiImage.size = Size.Portrait;
_genUiImage.quality = Quality.High;
_genUiImage.prompt = "A cute red panda eating crunchy biscuits.";
_genUiImage.Generate();

For security reasons you might want to explicitly pass API Key as a parameter in the Generate() method. Example:

// The most secure way to store the keys is to use a server
var keyObtainer = new MySecureCloudApiKeyObtainer();
var key = keyObtainer.GetOpenAiKey();

_genUiImage.Generate(apiKey: key);

How to get just Texture

Option 1

If you want to get just Texture you could get it via your GenUIImage instance by using Texture property (you need to make sure that you called Generate() before!).

_genUiImage.Generate();
var myTexture = _genUiImage.Texture;

Option 2

You can create an instance of GenRequestManager class and call GenerateTexture2D method. In this case, you might need to pass your API Key as a parameter.

public async Task<Texture2D> GenerateTexture2D(
    Provider provider,
    Model model,
    Quality quality,
    Size size,
    string prompt,
    string apiKey = "")
{
     // Handles your request
     // and returns a texture
}

GenRequestManager _genRequestManager = new GenRequestManager();
Texture myTexture = await _genRequestManager.GenerateTexture2D(
    provider: Provider.OpenAI,
    model: Model.GptImage1,
    quality: Quality.High,
    size: Size.Portrait,
    prompt: "A red panda climbing a tree and eating bamboo.",
    apiKey: "SecretApiKeyFromYourAiProvider"
)

Contact me

X | Bsky | Linkedin | Personal Site