Stable Diffusion 3

Generate an image using a Stable Diffusion 3 model:

SD3 Medium - the 2 billion parameter model

SD3 Large - the 8 billion parameter model

SD3 Large Turbo - the 8 billion parameter model with a faster inference time

This API is powered by Fireworks AI.
API status can be reviewed here.

Try it out

Grab your API key and head over to one of the following sites:

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 (SD3 Medium, SD3 Large, or SD3 Large Turbo)

output_format - the 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

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

SD3 Medium: Flat rate of 3.5 credits per successful generation.

SD3 Large: Flat rate of 6.5 credits per successful generation.

SD3 Large Turbo: Flat rate of 4 credits per successful generation.

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200Generation was successful.

application/json

Body

示例

{}

🟠400Invalid parameter(s), see the `errors` field for details.

🟠403Your request was flagged by our content moderation system.

🟠413Your request was larger than 10MiB.

🟠422You made a request with an unsupported language.

🟠429You have made more than 150 requests in 10 seconds.

🔴500An internal error occurred. If the problem persists [contact support](https://stabilityplatform.freshdesk.com/support/tickets/new).

Try it out#

How to use#

Generating with a prompt#

Generating with a prompt and an image#

Optional Parameters:#

Output#

Credits#

请求参数