FLUX.1 Schnell Image Generation

Generate high-quality images from text prompts. Send a request and receive the generated image directly in the response.

Quick Start

1. Get an API key (Console → API Keys).
2. Send a request: POST /v1/generate with Authorization: Bearer YOUR_API_KEY.
3. Receive the image in the response (PNG).

Endpoints

Method	Path	Description
POST	/v1/generate	Generate an image from a text prompt.

See API: Text-to-Image for full endpoint documentation.

Parameters Overview

Parameter	Required	Default	Description
model	Yes	—	Model identifier. Use "flux1-schnell".
prompt	Yes	—	Text description of the image to generate.
aspect_ratio	No	"landscape"	Resolution preset name (see table below).

Aspect Ratio Presets

Preset	Size	Aspect Ratio	Use Case
square	1024 × 1024	1:1	Profile photos, social media posts
landscape	1344 × 768	16:9	Desktop wallpapers, presentations
portrait	768 × 1344	9:16	Phone wallpapers, stories
photo	1248 × 832	3:2	Traditional photography
photo_v	832 × 1248	2:3	Vertical photography
standard	1184 × 896	4:3	Standard displays
standard_v	896 × 1184	3:4	Vertical standard
wide	1568 × 672	21:9	Ultrawide displays, cinematic

Error Responses

Status Code	Description
401 Unauthorized	Invalid or missing API key.
422 Unprocessable Entity	Invalid input (e.g., unsupported aspect ratio, missing prompt).
500 Internal Server Error	Server error.
504 Gateway Timeout	Generation timed out.