Stable Image Core

POST

/sd/v2beta/stable-image/generate/core

Generate

Our primary service for text-to-image generation, Stable Image Core represents the best quality achievable at high
speed. No prompt engineering is required! Try asking for a style, a scene, or a character, and see what you get.

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, and 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.

The body of the request should include:

prompt

The body may optionally include:

aspect_ratio

negative_prompt

seed

style_preset

output_format

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

Output

The resolution of the generated image will be 1.5 megapixels.

Credits

Flat rate of 3 credits per successful generation. You will not be charged for failed generations.

请求参数

Header 参数

authorization

string

必需

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.

>= 1 字符

content-type

string

必需

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

>= 1 字符

示例值:

multipart/form-data

enum<string>

必需

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

枚举值:

application/jsonimage/*

默认值:

image/*

Body 参数multipart/form-data

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.

>= 1 字符<= 10000 字符

aspect_ratio

enum<string>

可选

Controls the aspect ratio of the generated image.

枚举值:

16:91:121:92:33:24:55:49:169:21

默认值:

1:1

示例值:

1:1

negative_prompt

string

可选

A blurb of text describing what you do not wish to see in the output image.
This is an advanced feature.

<= 10000 字符

seed

number

可选

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

>= 0<= 4294967294

默认值:

style_preset

enum<string>

可选

Guides the image model towards a particular style.

枚举值:

3d-modelanalog-filmanimecinematiccomic-bookdigital-artenhancefantasy-artisometricline-artlow-polymodeling-compoundneon-punkorigamiphotographicpixel-arttile-texture

output_format

enum<string>

可选

Dictates the content-type of the generated image.

枚举值:

jpegpngwebp

默认值:

png

示例值:

png

示例代码

Python

JavaScript

Shell

Java

Swift

PHP

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/sd/v2beta/stable-image/generate/core' \
--header 'authorization;' \
--header 'accept;' \
--form 'prompt=""' \
--form 'aspect_ratio="1:1"' \
--form 'negative_prompt=""' \
--form 'seed=""' \
--form 'style_preset=""' \
--form 'output_format="png"'

返回响应

🟢200Generation was successful.

application/json

Body

object {0}

示例

{}

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

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

🟠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).

Stable Image Ultra

Stable Diffusion 3

Stable Image Core

Try it out#

How to use#

Output#

Credits#

请求参数

示例代码

返回响应

Try it out

How to use

Output

Credits