> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/stability-ai.md).

# Stability AI

Generate, upscale, and edit images with Stability AI's Stable Image API.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector    | Authentication |
| ------------ | -------------- |
| Stability AI | API Key        |

### Stability AI

Connect to Stability AI to generate, upscale, and edit images with Stable Image.

#### Set up in Stability AI

1. Prepare the Stability AI account or service that the workflow will access. Grant access to the required resources and operations.
2. **API Key:** Create and copy a Stability AI API key from your account.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Stability AI**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                  |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| API Key       | Yes      | Create and copy a Stability AI API key from your account. [Provider instructions](https://platform.stability.ai/account/keys). |

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Stability AI** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Generate Image from Text

Create an image from a written description with Stability AI Core.

#### Inputs

| Field           | Type            | Required | Description                                                                                                                                                                                                                                                   |
| --------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Prompt          | textarea        | Yes      | Describe the image to create.                                                                                                                                                                                                                                 |
| Aspect Ratio    | select (string) | No       | Choose the image shape. Available values: 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21. Default: 1:1.                                                                                                                                                      |
| Negative Prompt | textarea        | No       | Describe elements to avoid in the image.                                                                                                                                                                                                                      |
| Seed            | integer         | No       | Reuse a seed to make results more repeatable. Minimum: 0. Maximum: 4294967294.                                                                                                                                                                                |
| Style           | select (string) | No       | Guide the image toward a visual style. Available values: Enhance, Anime, Photographic, Digital Art, Comic Book, Fantasy Art, Line Art, Analog Film, Neon Punk, Isometric, Low Poly, Origami, Modeling Compound, Cinematic, 3D Model, Pixel Art, Tile Texture. |
| Output Format   | select (string) | No       | Choose the generated image file format. Available values: PNG, JPEG, WebP. Default: png.                                                                                                                                                                      |

#### Outputs

| Field         | Type         | Description                                  |
| ------------- | ------------ | -------------------------------------------- |
| Image         | binary\_file | Generated image file.                        |
| Media Type    | string       | MIME type of the generated image.            |
| Finish Reason | string       | Why Stability AI finished the request.       |
| Seed Used     | integer      | Seed Stability AI used for the result.       |
| Request ID    | string       | Stability AI request identifier for support. |

### Upscale Image

Enlarge an image to four times its original dimensions. Input width and height must each be 32 to 1,536 pixels and total at most 1,048,576 pixels.

#### Inputs

| Field         | Type            | Required | Description                                                                                                                  |
| ------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Image         | binary\_file    | Yes      | JPEG, PNG, or WebP image to enlarge. Width and height must each be 32 to 1,536 pixels, with 1,024 to 1,048,576 total pixels. |
| Output Format | select (string) | No       | Choose the upscaled image file format. Available values: PNG, JPEG, WebP. Default: png.                                      |

#### Outputs

| Field         | Type         | Description                                  |
| ------------- | ------------ | -------------------------------------------- |
| Image         | binary\_file | Upscaled image file.                         |
| Media Type    | string       | MIME type of the upscaled image.             |
| Finish Reason | string       | Why Stability AI finished the request.       |
| Seed Used     | integer      | Seed returned for the result when present.   |
| Request ID    | string       | Stability AI request identifier for support. |

### Inpaint Image

Replace a selected or transparent area of an image using a prompt.

#### Inputs

| Field           | Type            | Required | Description                                                                                                                                                                                                                                                          |
| --------------- | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image           | binary\_file    | Yes      | JPEG, PNG, or WebP image to edit.                                                                                                                                                                                                                                    |
| Prompt          | textarea        | Yes      | Describe what should appear in the edited area.                                                                                                                                                                                                                      |
| Mask            | binary\_file    | No       | Optional black-to-white mask image.                                                                                                                                                                                                                                  |
| Negative Prompt | textarea        | No       | Describe elements to avoid in the edited result.                                                                                                                                                                                                                     |
| Grow Mask       | integer         | No       | Expand the mask edge to blend the edit. Minimum: 0. Maximum: 100. Default: 5.                                                                                                                                                                                        |
| Seed            | integer         | No       | Reuse a seed to make results more repeatable. Minimum: 0. Maximum: 4294967294.                                                                                                                                                                                       |
| Style           | select (string) | No       | Guide the edited image toward a visual style. Available values: Enhance, Anime, Photographic, Digital Art, Comic Book, Fantasy Art, Line Art, Analog Film, Neon Punk, Isometric, Low Poly, Origami, Modeling Compound, Cinematic, 3D Model, Pixel Art, Tile Texture. |
| Output Format   | select (string) | No       | Choose the edited image file format. Available values: PNG, JPEG, WebP. Default: png.                                                                                                                                                                                |

#### Outputs

| Field         | Type         | Description                                  |
| ------------- | ------------ | -------------------------------------------- |
| Image         | binary\_file | Inpainted image file.                        |
| Media Type    | string       | MIME type of the inpainted image.            |
| Finish Reason | string       | Why Stability AI finished the request.       |
| Seed Used     | integer      | Seed Stability AI used for the result.       |
| Request ID    | string       | Stability AI request identifier for support. |

### Remove Background

Remove an image background and keep the foreground transparent.

#### Inputs

| Field         | Type            | Required | Description                                                                            |
| ------------- | --------------- | -------- | -------------------------------------------------------------------------------------- |
| Image         | binary\_file    | Yes      | JPEG, PNG, or WebP image whose background should be removed.                           |
| Output Format | select (string) | No       | Choose a transparent-capable output format. Available values: PNG, WebP. Default: png. |

#### Outputs

| Field         | Type         | Description                                  |
| ------------- | ------------ | -------------------------------------------- |
| Image         | binary\_file | Transparent foreground image file.           |
| Media Type    | string       | MIME type of the foreground image.           |
| Finish Reason | string       | Why Stability AI finished the request.       |
| Seed Used     | integer      | Seed returned for the result when present.   |
| Request ID    | string       | Stability AI request identifier for support. |

### Outpaint Image

Extend an image beyond one or more existing edges.

#### Inputs

| Field         | Type            | Required | Description                                                                                                                                                                                                                                                            |
| ------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Image         | binary\_file    | Yes      | JPEG, PNG, or WebP image to extend.                                                                                                                                                                                                                                    |
| Extend Left   | integer         | No       | Pixels to add on the left edge. Minimum: 0. Maximum: 2000. Default: 0.                                                                                                                                                                                                 |
| Extend Right  | integer         | No       | Pixels to add on the right edge. Minimum: 0. Maximum: 2000. Default: 0.                                                                                                                                                                                                |
| Extend Up     | integer         | No       | Pixels to add above the image. Minimum: 0. Maximum: 2000. Default: 0.                                                                                                                                                                                                  |
| Extend Down   | integer         | No       | Pixels to add below the image. Minimum: 0. Maximum: 2000. Default: 0.                                                                                                                                                                                                  |
| Prompt        | textarea        | No       | Optionally describe what should appear in the new area.                                                                                                                                                                                                                |
| Creativity    | number          | No       | Control how imaginative the new area may be. Minimum: 0. Maximum: 1. Default: 0.5.                                                                                                                                                                                     |
| Seed          | integer         | No       | Reuse a seed to make results more repeatable. Minimum: 0. Maximum: 4294967294.                                                                                                                                                                                         |
| Style         | select (string) | No       | Guide the expanded image toward a visual style. Available values: Enhance, Anime, Photographic, Digital Art, Comic Book, Fantasy Art, Line Art, Analog Film, Neon Punk, Isometric, Low Poly, Origami, Modeling Compound, Cinematic, 3D Model, Pixel Art, Tile Texture. |
| Output Format | select (string) | No       | Choose the expanded image file format. Available values: PNG, JPEG, WebP. Default: png.                                                                                                                                                                                |

#### Outputs

| Field         | Type         | Description                                  |
| ------------- | ------------ | -------------------------------------------- |
| Image         | binary\_file | Outpainted image file.                       |
| Media Type    | string       | MIME type of the outpainted image.           |
| Finish Reason | string       | Why Stability AI finished the request.       |
| Seed Used     | integer      | Seed Stability AI used for the result.       |
| Request ID    | string       | Stability AI request identifier for support. |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/stability-ai.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
