stable-diffusion-v3-medium

This documentation is valid for the following list of our models:

• stable-diffusion-v3-medium

Model Overview

An advanced text-to-image generation model that utilizes a Multimodal Diffusion Transformer (MMDiT) architecture to produce high-quality images from textual descriptions.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

Submit a request

API Schema

post

Authorizations

Body

modelundefined · enumRequiredAvailable options:

image_sizeany ofOptionalDefault: square_hd

For both height and width, the value must be a multiple of 32.

The size of the generated image

negative_promptstringOptional

The description of elements to avoid in the generated image

prompt_expansionbooleanOptional

If set to true, prompt will be upsampled with more details

guidance_scalenumber · min: 1 · max: 20Optional

The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you

num_inference_stepsinteger · min: 1 · max: 50Optional

The number of inference steps to perform

enable_safety_checkerbooleanOptional

If set to true, the safety checker will be enabled

Default: true

promptstring · max: 4000Required

The prompt to generate an image from

num_imagesnumber · min: 1 · max: 4Optional

The number of images to generate

Default: 1

seedinteger · min: 1Optional

The same seed and the same prompt given to the same version of the model will output the same image every time

Responses

post

HTTPcURLJavaScriptPython

POST /v1/images/generations HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer <YOUR_AIMLAPI_KEY>
Content-Type: application/json
Accept: */*
Content-Length: 235

{
  "model": "stable-diffusion-v3-medium",
  "image_size": {
    "width": 1,
    "height": 1
  },
  "negative_prompt": "text",
  "prompt_expansion": true,
  "guidance_scale": 1,
  "num_inference_steps": 1,
  "enable_safety_checker": true,
  "prompt": "text",
  "num_images": 1,
  "seed": 1
}

201Success

No content