> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recraft V4.1 – Text-to-Image API | Magnific API

> Generate design-ready images with Recraft V4.1. Two quality tiers, a literal utility mode for diagrams and mockups, and best-in-class in-image text rendering.

<Card title="Recraft V4.1" icon="wand-magic-sparkles">
  The latest Recraft generation. Design-oriented output with legible in-image text, two quality tiers, and a literal `utility` mode for diagrams and mockups.
</Card>

Recraft V4.1 is a text-to-image API built for design work rather than photography: posters, signage, packaging, editorial layouts and UI mockups. Its main strength is rendering text that is actually readable and correctly spelled inside the image. Two parameters shape the output: `tier` selects quality and size (and sets the price), and `variant` selects how literally the model follows your prompt. For the previous generation, see <a href="/api-reference/text-to-image/recraft-v4/overview">Recraft V4</a> and <a href="/api-reference/text-to-image/recraft-v4-pro/overview">Recraft V4 Pro</a>.

### Key capabilities

* **Two quality tiers**: `tier` accepts `mid` and `pro`. `pro` doubles both output dimensions — four times the pixels — and costs more credits
* **Standard and utility modes**: `variant` accepts `standard` and `utility`. `standard` lets the model apply its own art direction; `utility` renders exactly what you describe, with no invented colour or ornament. The variant does not change the price
* **In-image text**: renders legible words and short phrases — signage, labels, headlines — which most diffusion models struggle with
* **Eleven aspect ratios**: from `vertical_1_2` to `horizontal_2_1`, each with a documented pixel size per tier
* **Optional prompt rewriting**: `enhance_prompt` is on by default and expands your prompt into a richer design brief, preserving any text the image must render. Turn it off for a deterministic input
* **Async processing**: every request returns a task ID immediately. Poll the task endpoint or supply `webhook_url` to be notified on completion

### Use cases

* **Posters and signage**: designs whose wording has to be readable and correctly spelled
* **Packaging mockups**: labels and boxes with real text rather than text-shaped noise
* **UI and wireframes**: with `variant: "utility"`, clean interface mockups without invented styling
* **Diagrams and schematics**: literal renders that follow the brief instead of decorating it
* **Brand and editorial assets**: with `variant: "standard"`, finished pieces with their own art direction

### Generate images with Recraft V4.1

Submit a prompt to create a generation task. The API responds with a task ID; collect the result by polling or via webhook.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/text-to-image/recraft-v4-1" icon="wand-magic-sparkles" href="/api-reference/text-to-image/recraft-v4-1/generate">
      Create a new image generation task
    </Card>

    <Card title="GET /v1/ai/text-to-image/recraft-v4-1" icon="list" href="/api-reference/text-to-image/recraft-v4-1/recraft-v4-1-tasks">
      List all Recraft V4.1 tasks with status
    </Card>

    <Card title="GET /v1/ai/text-to-image/recraft-v4-1/{task-id}" icon="magnifying-glass" href="/api-reference/text-to-image/recraft-v4-1/task-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `prompt` | `string` | Yes | - | Text description of the image to generate, up to 10,000 characters. Spell out any wording the design must contain |
| `tier` | `string` | No | `mid` | Quality tier: `mid` or `pro`. Sets both the output size and the credit cost — see Pricing below |
| `variant` | `string` | No | `standard` | `standard` applies the model's own art direction; `utility` renders literally, with no invented colour or ornament. Does not affect the price |
| `aspect_ratio` | `string` | No | `square_1_1` | Shape of the output. See the size table below for the exact pixels each value produces |
| `enhance_prompt` | `boolean` | No | `true` | Rewrite the prompt with an LLM before generating. Text the image must render is preserved verbatim. Set to `false` to send the prompt exactly as written |
| `webhook_url` | `string` | No | - | URL called when the task completes |

### Output sizes

Recraft renders from a fixed set of sizes. The values below are the exact pixel dimensions each `aspect_ratio` produces, and they are **not always the mathematical ratio the name suggests** — `widescreen_16_9` renders 1344x768, which is 7:4.

| `aspect_ratio` | `tier: mid` | `tier: pro` |
| - | - | - |
| `square_1_1` | 1024x1024 | 2048x2048 |
| `horizontal_2_1` | 1536x768 | 3072x1536 |
| `vertical_1_2` | 768x1536 | 1536x3072 |
| `standard_3_2` | 1280x832 | 2560x1664 |
| `portrait_2_3` | 832x1280 | 1664x2560 |
| `classic_4_3` | 1216x896 | 2432x1792 |
| `traditional_3_4` | 896x1216 | 1792x2432 |
| `social_5_4` | 1152x896 | 2304x1792 |
| `social_post_4_5` | 896x1152 | 1792x2304 |
| `widescreen_16_9` | 1344x768 | 2688x1536 |
| `social_story_9_16` | 768x1344 | 1536x2688 |

### Pricing

`tier` sets the price. `tier: "mid"` is billed as Recraft V4 and `tier: "pro"` as Recraft V4 Pro. `variant` and `aspect_ratio` do not change the cost.

One image is generated per request.

The endpoint reference pages above are generated from the OpenAPI specification and are the authoritative, complete parameter list.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Recraft V4.1 and how does it work?">
    Recraft V4.1 is a text-to-image API aimed at design output rather than photography. You submit a text prompt and receive a task ID immediately. Poll the task endpoint or configure a webhook to receive the generated image when processing completes.
  </Accordion>

  <Accordion title="What is the difference between the standard and utility variants?">
    `standard` lets the model apply its own visual judgement — palette, decoration, display typography — which suits finished design pieces. `utility` renders exactly what you describe, with no invented colour or ornament, which suits diagrams, wireframes and UI mockups where the output has to follow the brief rather than reinterpret it. Both cost the same.
  </Accordion>

  <Accordion title="What does the tier parameter change?">
    `tier` selects quality and size at once. `pro` renders at twice the linear dimensions of `mid` — four times the pixels — and is billed at the Recraft V4 Pro rate. `mid` is the default and is billed as Recraft V4.
  </Accordion>

  <Accordion title="Why does widescreen_16_9 not return a 16:9 image?">
    Recraft generates from a fixed set of sizes, and the preset names are approximate. `widescreen_16_9` returns 1344x768 at `mid`, which is 7:4 rather than 16:9. The size table above lists the exact dimensions for every value, so you can pick by pixels instead of by name.
  </Accordion>

  <Accordion title="What does enhance_prompt do to my prompt?">
    It rewrites the prompt with an LLM before generation, expanding it with composition, layout and typography detail. Any text the image must display is preserved verbatim, including spelling and capitalisation. Set it to `false` when you need the model to receive exactly the string you sent.
  </Accordion>

  <Accordion title="How many images can I generate per request?">
    One. Submit multiple requests to generate variations.
  </Accordion>

  <Accordion title="What are the rate limits for Recraft V4.1?">
    Rate limits depend on your subscription tier. See [Rate Limits](/ratelimits) for current limits.
  </Accordion>

  <Accordion title="How much does Recraft V4.1 cost?">
    Cost depends on the `tier` you request. See the [Pricing page](/pricing) for current rates and subscription options.
  </Accordion>
</AccordionGroup>

## Best practices

* **Pick the variant first**: `utility` for anything that must follow the brief exactly, `standard` for finished design pieces. It costs nothing to switch
* **Quote the text**: put the exact string you want rendered in quotes inside the prompt, and keep it short
* **Draft at `mid`, finish at `pro`**: the prompt does not need to change between tiers
* **Choose the ratio by pixels**: use the size table rather than the preset name, which is approximate
* **Turn off `enhance_prompt` for reproducibility**: when you are A/B testing prompts, the rewrite adds a variable you do not control
* **Production integration**: use `webhook_url` instead of polling for scalable applications
* **Error handling**: implement retry logic with exponential backoff for 503 errors

## Related APIs

* **[Recraft V4](/api-reference/text-to-image/recraft-v4/overview)**: the previous generation at the same sizes as `tier: "mid"`
* **[Recraft V4 Pro](/api-reference/text-to-image/recraft-v4-pro/overview)**: the previous generation at the same sizes as `tier: "pro"`
* **[GPT Image 2](/api-reference/text-to-image/gpt-image-2/overview)**: OpenAI generation, also strong at in-image text
* **[Seedream 5 Pro](/api-reference/text-to-image/post-seedream-v5-pro)**: high-resolution text-to-image with a generate and edit split


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.