Flux Schnell

Playground

FLUX.1 [schnell] is a 12B rectified flow transformer for high-quality text-to-image generation via API. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

FLUX.1 Schnell — wavespeed-ai/flux-schnell

wavespeed-ai/flux-schnell is an ultra-fast text-to-image model designed for high-throughput generation and rapid iteration. It’s ideal when you want to explore ideas quickly, batch-generate variations, or power real-time creative workflows with consistent, production-friendly latency.

What it’s good at

Fast text-to-image generation for rapid prompt iteration
High-throughput batches (great for grids, A/B testing, and variations)
Concepting & ideation (style exploration, composition discovery)
Lightweight production use where speed matters more than maximum fidelity

Inputs

prompt (required): your text description
image (optional): reference image (if enabled in your deployment)
mask_image (optional): mask for inpainting / local edits (if enabled)
strength (optional): how strongly the model follows the reference/mask edit intent
size: output resolution (width/height)
num_images: number of images to generate
seed: random seed (-1 for random)
output_format: output format (e.g., jpeg)
enable_base64_output (API only): return base64 instead of a URL
enable_sync_mode (API only): wait for generation to finish before returning

Recommended settings

Quick iterations: keep prompts short and specific, generate multiple candidates (num_images > 1)
More control: lock the seed, then tweak one prompt element at a time
Editing/inpainting: start with strength ~0.6–0.85, then adjust based on how much change you want

Use cases

Marketing creative drafts: generate dozens of on-brand concept options fast
Game & animation concept art: rapid character/prop/environment exploration
Design exploration: packaging, posters, thumbnails, UI mood boards
Prompt prototyping: build “prompt recipes” before switching to higher-fidelity models
Batch generation pipelines: large-scale variation sweeps for selection and ranking

Pricing

Model	Price per image
wavespeed-ai/flux-schnell	$0.003

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/flux-schnell" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "strength": 0.8,
    "size": "1024*1024",
    "num_images": 1,
    "seed": -1,
    "output_format": "jpeg",
    "enable_base64_output": false,
    "enable_sync_mode": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
image	string	No		-
mask_image	string	No		-	The mask image tells the model where to generate new pixels (white) and where to preserve the original image (black). It acts as a stencil or guide for targeted image editing.
strength	number	No	0.8	0.00 ~ 1.00	Strength indicates extent to transform the reference image.
size	string	No	1024*1024	256 ~ 1536 per dimension	The size of the generated media in pixels (width*height).
num_images	integer	No	1	1 ~ 4	The number of images to generate.
seed	integer	No	-1	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.
output_format	string	No	jpeg	jpeg, png, webp	The format of the output image.
enable_base64_output	boolean	No	false	-	If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.
enable_sync_mode	boolean	No	false	-	If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Flux Redux Pro Flux Schnell LoRA