Skip to main content

Recraft V4

Design-oriented text-to-image generation with legible in-image text, across eleven fixed aspect ratios.
Recraft V4 is a text-to-image API built for design work rather than photography: posters, signage, packaging and editorial layouts. Its main strength is rendering text that is actually readable and correctly spelled inside the image, which most diffusion models struggle with. For the same model at twice the linear dimensions, see Recraft V4 Pro; for the newer generation with quality tiers and a literal rendering mode, see Recraft V4.1.

​
Key capabilities

  • In-image text: renders legible words and short phrases — signage, labels, headlines — reliably enough to use in finished design work
  • Design-first output: composition, typography and layout rather than photographic realism
  • Eleven aspect ratios: from vertical_1_2 to horizontal_2_1, each with a documented pixel size
  • 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
  • Editorial illustration: article and newsletter art generated from a detailed brief
  • Brand assets: key visuals where the headline or product name appears inside the image

​
Generate images with Recraft V4

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

POST /v1/ai/text-to-image/recraft-v4

Create a new image generation task

GET /v1/ai/text-to-image/recraft-v4

List all Recraft V4 tasks with status

GET /v1/ai/text-to-image/recraft-v4/{task-id}

Get task status and results by ID

​
Parameters

​
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.

​
Pricing

A flat price per image. One image is generated per request. Recraft V4 Pro renders the same aspect ratios at twice the linear dimensions for a higher price. The endpoint reference pages above are generated from the OpenAPI specification and are the authoritative, complete parameter list.

​
Frequently Asked Questions

Recraft V4 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.
Yes — it is the main reason to choose it. Short, specific strings such as a product name, a headline or a sign work best. Put the exact wording in quotes inside your prompt.
Same model family and the same parameters; V4 Pro renders every aspect ratio at twice the linear dimensions — four times the pixels — and costs more credits per image.
Recraft generates from a fixed set of sizes, and the preset names are approximate. widescreen_16_9 returns 1344x768, which is 7:4. The size table above lists the exact dimensions for every value.
One. Submit multiple requests to generate variations.
Rate limits depend on your subscription tier. See Rate Limits for current limits.
See the Pricing page for current rates and subscription options.

​
Best practices

  • Quote the text: put the exact string you want rendered in quotes inside the prompt, and keep it short
  • Describe the design, not just the subject: layout, palette and typography style guide the output more than keyword lists
  • Choose the ratio by pixels: use the size table rather than the preset name, which is approximate
  • Turn off enhance_prompt for reproducibility: when 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
  • Recraft V4 Pro: the same model at twice the linear dimensions
  • Recraft V4.1: the newer generation, with quality tiers and a literal utility mode
  • GPT Image 2: OpenAI generation, also strong at in-image text