Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Your Stability API key, sent as a bearer token in the Authorization header.

Headers

accept
enum<string>
default:image/*

Specify image/* to receive the bytes of the image directly. Otherwise specify application/json to receive the image as base64 encoded JSON.

Available options:
image/*,
application/json
stability-client-id
string

The name of your application, used to help us communicate app-specific debugging or moderation issues to you.

Maximum string length: 256
Example:

"my-awesome-app"

stability-client-user-id
string

A unique identifier for your end user. Used to help us communicate user-specific debugging or moderation issues to you. Feel free to obfuscate this value to protect user privacy.

Maximum string length: 256
Example:

"DiscordUser#9999"

stability-client-version
string

The version of your application, used to help us communicate version-specific debugging or moderation issues to you.

Maximum string length: 256
Example:

"1.2.1"

Body

multipart/form-data
image
file
required

The image you wish to outpaint.

Supported Formats:

  • jpeg
  • png
  • webp

Validation Rules:

  • Every side must be at least 64 pixels
  • Total pixel count must be between 4,096 and 9,437,184 pixels
  • The aspect ratio must be between 1:2.5 and 2.5:1
left
integer
default:0

The number of pixels to outpaint on the left side of the image. At least one outpainting direction must be supplied with a non-zero value.

Required range: 0 <= x <= 2000
right
integer
default:0

The number of pixels to outpaint on the right side of the image. At least one outpainting direction must be supplied with a non-zero value.

Required range: 0 <= x <= 2000
up
integer
default:0

The number of pixels to outpaint on the top of the image. At least one outpainting direction must be supplied with a non-zero value.

Required range: 0 <= x <= 2000
down
integer
default:0

The number of pixels to outpaint on the bottom of the image. At least one outpainting direction must be supplied with a non-zero value.

Required range: 0 <= x <= 2000
creativity
number
default:0.5

Controls the likelihood of creating additional details not heavily conditioned by the init image.

Required range: 0.2 <= x <= 0.5
prompt
string

What you wish to see in the output image. A strong, descriptive prompt that clearly defines elements, colors, and subjects will lead to better results.

To control the weight of a given word use the format (word:weight), where word is the word you'd like to control the weight of and weight is a value between 0 and 1. For example: The sky was a crisp (blue:0.3) and (green:0.8) would convey a sky that was blue and green, but more green than blue.

Maximum string length: 10000
seed
number
default:0

A specific value that is used to guide the 'randomness' of the generation. (Omit this parameter or pass 0 to use a random seed.)

Required range: 0 <= x <= 4294967294
output_format
enum<string>
default:png

Dictates the content-type of the generated image.

Available options:
png,
jpeg,
webp
style_preset
enum<string>

Guides the image model towards a particular style.

Available options:
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

Response

Outpainting was successful.

The bytes of the generated image.

The finish-reason and seed will be present as headers.