import requests

response = requests.post(
    f"https://api.stability.ai/v2beta/stable-image/generate/sd3",
    headers={
        "authorization": f"Bearer sk-MYAPIKEY",
        "accept": "image/*"
    },
    files={"none": ''},
    data={
        "prompt": "Lighthouse on a cliff overlooking the ocean",
        "output_format": "jpeg",
    },
)

if response.status_code == 200:
    with open("./lighthouse.jpeg", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))

"The bytes of the generated jpeg"

Generate

Stable Diffusion 3.5

Generate using Stable Diffusion 3.5 models, Stability AI latest base model:

Stable Diffusion 3.5 Large: At 8 billion parameters, with superior quality and prompt adherence, this base model is the most powerful in the Stable Diffusion family. This model is ideal for professional use cases at 1 megapixel resolution.
Stable Diffusion 3.5 Large Turbo: A distilled version of Stable Diffusion 3.5 Large. SD3.5 Large Turbo generates high-quality images with exceptional prompt adherence in just 4 steps, making it considerably faster than Stable Diffusion 3.5 Large.
Stable Diffusion 3.5 Medium: With 2.5 billion parameters, the model delivers an optimal balance between prompt accuracy and image quality, making it an efficient choice for fast high-performance image generation.
Stable Diffusion 3.5 Flash: A distilled version of Stable Diffusion 3.5 Medium. SD3.5 Flash generates high-quality images with a 4 step process instead of 40, making it faster than Stable Diffusion 3.5 Medium.

Read more about the model capabilities here.

As of April 17, 2025, we have deprecated the Stable Diffusion 3.0 APIs and will be automatically re-routing calls to Stable Diffusion 3.0 models to Stable Diffusion 3.5 APIs at no extra cost. You can read more in the release notes.

Try it out

Grab your API key and head over to

How to use

Please invoke this endpoint with a POST request.

The headers of the request must include an API key in the authorization field. The body of the request must be multipart/form-data. The accept header should be set to one of the following:

image/* to receive the image in the format specified by the output_format parameter.
application/json to receive the image encoded as base64 in a JSON response.

Generating with a prompt

Commonly referred to as text-to-image, this mode generates an image from text alone. While the only required parameter is the prompt, it also supports an aspect_ratio parameter which can be used to control the aspect ratio of the generated image.

**Generating with a prompt and an image**

Commonly referred to as image-to-image, this mode also generates an image from text but uses an existing image as the starting point. The required parameters are:

prompt - text to generate the image from
image - the image to use as the starting point for the generation
strength - controls how much influence the image parameter has on the output image
mode - must be set to image-to-image

Note: maximum request size is 10MiB.

Optional Parameters:

Both modes support the following optional parameters:

model - the model to use (SD 3.5 Large, SD 3.5 Large Turbo, SD 3.5 Medium, SD 3.5 Flash)
output_format - the format of the output image
seed - the randomness seed to use for the generation
negative_prompt - keywords of what you do not wish to see in the output image
cfg_scale - controls how strictly the diffusion process adheres to the prompt text
style_preset - guides the image model towards a particular style

Note: for more details about these parameters please see the request schema below.

Output

The resolution of the generated image will be 1MP. The default resolution is 1024x1024.

Credits

SD 3.5 Large: Flat rate of 6.5 credits per successful generation.
SD 3.5 Large Turbo: Flat rate of 4 credits per successful generation.
SD 3.5 Medium: Flat rate of 3.5 credits per successful generation.
SD 3.5 Flash: Flat rate of 2.5 credits per successful generation.

As always, you will not be charged for failed generations.

POST

v2beta

stable-image

generate

sd3

import requests

response = requests.post(
    f"https://api.stability.ai/v2beta/stable-image/generate/sd3",
    headers={
        "authorization": f"Bearer sk-MYAPIKEY",
        "accept": "image/*"
    },
    files={"none": ''},
    data={
        "prompt": "Lighthouse on a cliff overlooking the ocean",
        "output_format": "jpeg",
    },
)

if response.status_code == 200:
    with open("./lighthouse.jpeg", 'wb') as file:
        file.write(response.content)
else:
    raise Exception(str(response.json()))

"The bytes of the generated jpeg"

Authorizations

authorization

string

header

required

Use your Stability API key to authentication requests to this App.

Headers

authorization

string

required

Your Stability API key, used to authenticate your requests. Although you may have multiple keys in your account, you should use the same key for all requests to this API.

Minimum string length: 1

content-type

string

required

The content type of the request body. Do not manually specify this header; your HTTP client library will automatically include the appropriate boundary parameter.

Minimum string length: 1

Example:

"multipart/form-data"

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

prompt

string

required

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.

Required string length: 1 - 10000

mode

enum<string>

default:text-to-image

Controls whether this is a text-to-image or image-to-image generation, which affects which parameters are required:

text-to-image requires only the prompt parameter
image-to-image requires the prompt, image, and strength parameters

Available options:

text-to-image,

image-to-image

image

file

The image to use as the starting point for the generation.

Supported formats:

jpeg
png
webp

Supported dimensions:

Every side must be at least 64 pixels

Important: This parameter is only valid for image-to-image requests.

strength

number

Sometimes referred to as denoising, this parameter controls how much influence the image parameter has on the generated image. A value of 0 would yield an image that is identical to the input. A value of 1 would be as if you passed in no image at all.

Important: This parameter is only valid for image-to-image requests. For SD 3.5 Flash, the best results for image-to-image generation are achieved with a strength between .94 - .97.

Required range: 0 <= x <= 1

aspect_ratio

enum<string>

default:1:1

Controls the aspect ratio of the generated image. Defaults to 1:1.

Important: This parameter is only valid for text-to-image requests.

Available options:

21:9,

16:9,

3:2,

5:4,

1:1,

4:5,

2:3,

9:16,

9:21

model

enum<string>

default:sd3.5-large

The model to use for generation.

sd3.5-large requires 6.5 credits per generation
sd3.5-large-turbo requires 4 credits per generation
sd3.5-medium requires 3.5 credits per generation
sd3.5-flash requires 2.5 credits per generation
As of the April 17, 2025, sd3-large, sd3-large-turbo and sd3-medium are re-routed to their sd3.5-[model version] equivalent, at the same price.

Available options:

sd3.5-large,

sd3.5-large-turbo,

sd3.5-medium

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

negative_prompt

string

Keywords of what you do not wish to see in the output image. This is an advanced feature.

Maximum string length: 10000

cfg_scale

number

How strictly the diffusion process adheres to the prompt text (higher values keep your image closer to your prompt). The Large and Medium models use a default of 4. The Turbo and Flash model uses a default of 1.

Required range: 1 <= x <= 10

Response

Generation was successful.

The bytes of the generated image.

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