Flux 2 Turbo Text To Image
Playground
Try it on WaveSpeedAI!FLUX 2 turbo from Black Forest Labs is the speed-optimized text-to-image model for real-time workflows. Generate photoreal images and clean typography with strong prompt adherence and consistent style—ideal for ads, posters, social posts, and rapid iteration. Built for low-latency, high-throughput use. Ready-to-use REST API, best performance, no cold starts, affordable pricing.
Features
FLUX.2 [turbo] is the speed-optimized text-to-image model in the FLUX.2 family, built for ultra-fast generation with strong prompt adherence and dependable output quality. It’s ideal for real-time creation, high-volume pipelines, and rapid iteration where latency matters.
Where FLUX.2 [turbo] fits best
- Real-time applications requiring low latency
- High-volume batch generation workflows
- Rapid iteration, prototyping, and creative exploration
- Cost-sensitive production pipelines that still need consistent quality
Key benefits
-
Turbo-fast generation Optimized for minimal latency so you can generate more variations per minute.
-
Quality you can ship Designed to preserve the core FLUX.2 look and coherence while prioritizing speed.
-
Prompt-smart outputs Handles detailed prompts (objects, lighting, style cues) with reliable composition and fewer “random surprises.”
-
Format-ready files Supports common output formats including JPEG, PNG, and WebP for web, design, and production workflows.
Parameters
| Parameter | Description |
|---|---|
| prompt* | Text description of the desired image (the more specific the prompt, the more consistent the result). |
| width | Output width (px). |
| height | Output height (px). |
| seed | Use -1 for random results, or set a fixed value for reproducible generations. |
How to use
- Write a detailed prompt describing subject, environment, style, and lighting.
- Set output size by choosing width and height (square for general use, wide for banners, tall for posters).
- Set a seed:
- Use -1 for random variations each run
- Use a fixed number to reproduce a result or explore controlled variations
- Run the model and download the generated image.
Pricing
- $0.01 per generated image
FLUX.2 family on WaveSpeedAI
- FLUX.2 [turbo] Edit – ultra-fast image-to-image editing.
- FLUX.2 [flash] Text-to-Image – lightning-fast text-to-image generation.
- FLUX.2 [pro] Text-to-Image – premium quality text-to-image.
- Flux-2-dev/text-to-image — Lightweight FLUX.2 text-to-image generation optimized for speed, large-batch runs, and LoRA training workflows.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
REQUEST_BODY=$(cat <<'JSON'
{
"prompt": "A cinematic ocean wave at sunrise, highly detailed",
"size": "1024*1024",
"seed": -1
}
JSON
)
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/flux-2-turbo/text-to-image" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}")
TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body \
"${RESULT_URL}" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}")
RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')
case "${STATUS}" in
completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
esac
doneParameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| size | string | No | 1024*1024 | - | The size of the generated media in pixels (width*height). |
| seed | integer | No | -1 | - | The random seed to use for the generation. -1 means a random seed will be used. |
| enable_sync_mode | boolean | No | false | - | If set to `true`, the request attempts to wait for the generated result and return outputs in the same response. If the result is not ready within the sync wait window, the API can return a timeout body while the task continues processing. This option is only available via the API and is supported only by some models. |
| enable_base64_output | boolean | No | false | - | If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN. |
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 | Output values, usually URL strings; some models return text strings or structured result objects (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 |
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 |
| data.model | string | Model ID used for the prediction |
| data.outputs | array<string | object> | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created |
| 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 |