---
title: "Flux 2 Turbo - Create image from text"
method: POST
path: "/v1/ai/text-to-image/flux-2-turbo"
tags: ["text-to-image"]
---

# Flux 2 Turbo - Create image from text

`POST /v1/ai/text-to-image/flux-2-turbo`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/text-to-image/flux-2-turbo`
- Auth: API key in header `x-magnific-api-key`

Create high-quality images quickly using FLUX.2 [turbo], the speed-optimized version of Flux 2.

**Key Features:**
- Fast generation (optimized for speed)
- Lower cost than Pro version
- Adjustable guidance scale for prompt adherence
- Custom image dimensions (512-2048px)
- Safety checker for content filtering
- Multiple output formats (PNG/JPEG)

**Use Cases:**
- Rapid prototyping and iteration
- Content exploration
- High-volume generation
- Testing prompts and concepts

## Request body

- Ttif2tRequestContent
  - `prompt` string, required: Text description of the image you want to generate. **FLUX.2 [turbo]** is optimized for speed while maintaining good quality. Perfect for rapid prototyping and testing. **Performance:** - Faster generation than Flux 2 Pro - Lower cost per generation - Great for iteration and experimentation **Tips:** - Works best with clear, descriptive prompts - Adjust guidance_scale for prompt adherence - Use seed for reproducibility **Examples:** - `"mountain landscape at golden hour"` - `"portrait of a smiling person, natural lighting, soft focus"` - `"abstract geometric pattern with vibrant colors"`
  - `guidance_scale` number: Controls how closely the model follows your prompt. **Range:** 1.0 to 20.0 **Default:** 2.5 **Guidelines:** - **Low (1-3):** More creative freedom, less literal interpretation - **Medium (3-7):** Balanced between creativity and prompt accuracy - **High (7-20):** Strict adherence to prompt, less creative variation **Recommendation:** Start with default (2.5) and adjust if needed.
  - `seed` integer, nullable: Random seed for reproducible results. **Valid range:** 0 to 4,294,967,295 **Default:** Random (if not provided) **Tip:** Save the seed from generations you like to create similar variations.
  - `image_size` Ttif2tRequestContentImageSize, nullable: Custom image dimensions (alternative to using standard aspect ratios). **Valid range:** 512 to 2048 pixels for both width and height **Default:** 1024×1024 if not specified **Note:** Total resolution affects cost and generation time.
    - `width` integer: Image width in pixels
    - `height` integer: Image height in pixels
  - `enable_safety_checker` boolean: Enable content safety filtering. **When enabled:** Filters potentially unsafe content (NSFW, violence, etc.) **When disabled:** No content filtering (use responsibly and in compliance with terms) **Recommendation:** Keep enabled for production applications.
  - `output_format` 'jpeg' | 'png': Output image format. **PNG:** - Lossless compression - Supports transparency - Larger file size - Best for graphics and illustrations **JPEG:** - Lossy compression - Smaller file size - No transparency - Best for photos and realistic images
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

## Response `200`

OK - Task created successfully

- CreateImageFromTextFlux200Response
  - `data` Task, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)