# Set up

> Connect Asset Studio to Vercel AI Gateway with your own key, then select the image model, the default size, and the other defaults for your project.

Source: https://docs.uniform.app/docs/apps/asset-studio/set-up

Before your team can generate images, add an AI Gateway key and select an image model. You do this one time for each project. Asset Studio saves each change automatically.

- Uniform activated Asset Studio for your team. If it did not, [request activation](https://docs.uniform.app/docs/apps/request-activation?app=Asset%20Studio).
- You have a [Vercel](https://vercel.com) account, and you can make API keys for your Vercel team.
- You can change the integration settings of the project in Uniform.

## Get an AI Gateway key

Asset Studio sends each generation to [Vercel AI Gateway](https://vercel.com/ai-gateway). AI Gateway gives access to image and text models from many providers with one key. Vercel bills the model costs to your Vercel team.

1. Sign in to the [Vercel dashboard](https://vercel.com/dashboard).
2. Select the Vercel team that pays for the generations.
3. Select **AI Gateway**.
4. Select **API Keys**, then select **Create key**.
5. Type a name for the key, such as `Uniform Asset Studio`, and create the key.
6. Copy the key. You need it in the next procedure.

> **Keep the key secret:**
>
> Everyone with the key can make generations that Vercel bills to your team. Give the key only to Asset Studio. If you think that someone else has the key, delete the key in Vercel and make a new one.

For more information about keys, credits, and spending limits, see the [AI Gateway documentation](https://vercel.com/docs/ai-gateway).

## Add the key to Asset Studio

1. In the Uniform dashboard, open the project.
2. Go to **Settings > Integrations**, and select **Asset Studio**.
3. On the **Connection** tab, paste the key into **AI Gateway API key**.
4. Select **Test connection**.

If the key works, Asset Studio shows how many image models and text models the key gives. If the test fails, make sure that you copied the full key and that the key is active in Vercel.

![Asset Studio settings on the Connection tab. A message says that the gateway key works and offers 31 image and 115 text models. Below it are a note that no Uniform API key is necessary, the hidden AI Gateway API key, and the Test connection button.](https://docs.uniform.app/images/apps/asset-studio/settings-connection.png)

Asset Studio does not need a Uniform API key. It uses the Uniform sign-in of each person. For more information, see [permissions for authors](#permissions-for-authors).

## Select the defaults

Open the **Generation** tab. These settings apply to all generations in the project. A [prompt](#set-up-the-ai-button) can use a different model or size. Open Graph backdrops always use the project image model at 1200 × 630.

| Setting | What it does |
| --- | --- |
| **Image model** | The model that makes the images. The list shows the image models from OpenAI, Black Forest Labs, xAI, ByteDance, and Recraft, with the newest first. It also shows the price of each image in credits, if the provider gives a price. 10 credits are 1 US dollar. |
| **Default image size** | The size that Asset Studio asks for: **Square — 1024 × 1024**, **Landscape — 1536 × 1024**, **Portrait — 1024 × 1536**, or **Social / OG — 1200 × 630**. Some models change the size to a size that they support. |
| **Accent colour** | The color of labels and highlights in card templates that do not set their own color. Select **Auto**, or select **Custom** and pick a color. |
| **Text model** | The model that writes a card template from a description. For more information, see [make a template from a description](https://docs.uniform.app/docs/apps/asset-studio/templates#make-a-template-from-a-description). |

![Asset Studio settings on the Generation tab, with Image model set to Black Forest Labs FLUX.2 pro, Default image size set to Landscape 1536 by 1024, Accent colour set to Auto, and Text model set to Anthropic Claude Haiku 4.5.](https://docs.uniform.app/images/apps/asset-studio/settings-generation.png)

> **Select a model that supports your sizes:**
>
> Some models accept only some sizes. For example, a model can reject the **Social / OG — 1200 × 630** size that Open Graph backdrops use. If a generation fails with a size error, select a different model. FLUX.2 [pro] from Black Forest Labs accepts all the sizes that Asset Studio asks for.

## Set up the AI button

Asset Studio adds two prompts to the AI button on asset parameters:

- **Generate image from a description**: the author types a description.
- **Generate image in a specific style**: the author types a subject and a visual style.

Each prompt can use its own model, size, style, and number of variations. If you do not set the model or the size, the prompt uses the project default. If you do not set the style, the prompt adds no style. If you do not set the variations, the prompt makes 2 images.

1. Go to **Settings > Prompts**.
2. Open an Asset Studio prompt.
3. In the Asset Studio settings of the prompt, set the values that you need:

   - **Image model**: a different model, or **Use the project default**.
   - **Image size**: a different size, or **Use the project default**.
   - **Style**: a style that Asset Studio adds to each prompt, such as **Editorial photography**. For the list of styles, see [styles](https://docs.uniform.app/docs/apps/asset-studio/generate-images#styles).
   - **Variations**: how many images Asset Studio makes each time, from 1 to 4.

![Asset Studio prompt settings: Image model set to Use the project default, Image size set to Landscape 1536 by 1024, Style set to Editorial photography, and Variations set to 1.](https://docs.uniform.app/images/apps/asset-studio/prompt-settings.png)

For more information about prompts in Uniform, see [AI prompts](https://docs.uniform.app/docs/guides/ai/ai-prompts).

## Permissions for authors

Asset Studio works as the person who uses it. It uses their Uniform sign-in and their permissions. Thus the same action can work for one person and fail for a different person. [Automations](#automations) are different: they run as a team role.

To publish an image, an author needs permission to add files and assets in the project. If an author does not have this permission, Asset Studio shows **Not allowed** and names the permission that is missing. A team admin can give the permission. For more information, see [roles and permissions](https://docs.uniform.app/docs/guides/roles-and-permissions).

## Automations

On the **Automations** tab, an administrator can make an automation that draws an [Open Graph card](https://docs.uniform.app/docs/apps/asset-studio/open-graph-cards) without an author. When an entry is published, or when it reaches a workflow stage, the automation fills a card template with the fields of the entry and publishes the card to the asset library. It can also put the card on the entry and move the entry to a different workflow stage.

To make an automation, select **New automation**, or select **Create automation** in the menu of a template on the **Templates** tab. Then select **Publish automation**.

An automation is different from the studio:

- It runs as the team role that you select in **Runs with the role**, not as an author. The role needs permission to write the entry at each workflow stage that the automation uses.
- It keeps a copy of the AI Gateway key and the models from the time that you publish it. If you change the key or the models, open the automation and select **Update automation**.

To stop an automation, delete it on the **Automations** tab.

## Change or remove the key

To change the key, paste the new key into **AI Gateway API key** on the **Connection** tab, then select **Test connection**. To stop all generations in the studio, delete the key from the field. Automations keep their own copy of the key: update each automation after you change the key, and delete each automation to stop it.

When you remove the key, the images that your team published stay in the asset library.