Create image

Creates one or more images from a text prompt.

Response headers

Inference-Id — Unique ID for this request. Include this when contacting support.

Error codes

Status	Meaning
`402`	Insufficient credits
`429`	Rate limited
`504`	No backend available
`529`	No healthy backends are available for the requested model

Authorization

BearerAuth

AuthorizationBearer <token>

API key passed as Bearer token

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*string

The image model to use, e.g. black-forest-labs/FLUX.1-schnell.

prompt*string

Text description of the desired image.

n?integer

Number of images to generate. Defaults to 1.

Range1 <= value <= 10

size?string

Image size as WIDTHxHEIGHT, e.g. 1024x1024, or auto to use the model's default size. Defaults vary by model.

Match^(auto|\d{1,5}x\d{1,5})$

response_format?string

Format of returned images.

Value in"b64_json"

user?string

End-user identifier for abuse monitoring.

negative_prompt?string

Text the model should avoid generating.

num_inference_steps?integer

Number of denoising steps. Higher = better quality, higher cost.

Range1 <= value <= 100

guidance_scale?number

Range0 <= value

true_cfg_scale?number

Range0 <= value

seed?integer

Deterministic seed for reproducible generation.

[key: string]?any

Response Body

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "string",    "prompt": "string"  }'

{
  "created": 0,
  "data": [
    {
      "b64_json": "string",
      "url": "string",
      "revised_prompt": "string"
    }
  ]
}

Create image

Authorization

Request Body

Response Body

200application/json

`application/json`