Recraft's latest text-to-image generation model with high-quality output, supporting various aspect ratios and custom color palettes
recraft-v4
Starting from
Prices shown are in USD
See all providersFastest generation through replicate at 17,359ms median latency with 100.0% success rate.
Aggregated from real API requests over the last 30 days.
| # | Provider | p50 Gen Time | p95 Gen Time | Success Rate | TTFB (p50) |
|---|---|---|---|---|---|
| 1 | replicate | 17,359ms | 23,941ms | 100.0% | 17,014ms |
| 2 | fal | 18,331ms | 26,621ms | 100.0% | 17,855ms |
Recraft V4 is available from 2 providers, with per-image pricing starting at $0.04 through fal.ai.
fal/recraft-v4
replicate/recraft-v4
Integrate Recraft V4 via the Lumenfall OpenAI-compatible API to programmatically generate high-fidelity images with built-in support for vector-inspired styles and precise text rendering.
https://api.lumenfall.ai/openai/v1
recraft-v4
curl -X POST \ https://api.lumenfall.ai/openai/v1/images/generations \ -H "Authorization: Bearer $LUMENFALL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "recraft-v4", "prompt": "", "size": "1024x1024" }'# Response:# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }import OpenAI from 'openai';const client = new OpenAI({ apiKey: 'YOUR_API_KEY', baseURL: 'https://api.lumenfall.ai/openai/v1'});const response = await client.images.generate({ model: 'recraft-v4', prompt: '', size: '1024x1024'});// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }console.log(response.data[0].url);from openai import OpenAIclient = OpenAI( api_key="YOUR_API_KEY", base_url="https://api.lumenfall.ai/openai/v1")response = client.images.generate( model="recraft-v4", prompt="", size="1024x1024")# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }print(response.data[0].url)| Parameter | Type | Description | Modes |
|---|---|---|---|
prompt
|
string | Required. Text prompt for image generation |
T2I
|
| Parameter | Type | Description | Modes |
|---|---|---|---|
size
|
string |
Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9")
WxH determines both shape and scale (aspect_ratio and resolution are ignored when size is provided). W:H format is equivalent to aspect_ratio.
|
T2I
|
aspect_ratio
|
string |
Aspect ratio of the output image (e.g. "16:9", "1:1")
Controls shape independently of scale. Use with resolution to control both. If size is also provided, size takes precedence. Any ratio is accepted and mapped to the nearest supported value.
|
T2I
|
resolution
|
string |
Output resolution tier (e.g. "1K", "4K")
1K
Controls scale independently of shape. Higher tiers produce larger images and cost more. If size is also provided, size takes precedence for scale. Any tier is accepted and mapped to the nearest supported value.
|
T2I
|
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| Flexible | |||
|
Custom
1–14142px per side
|
"WxH" |
— | Any pixel dimensions within model constraints |
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| 768 × 1536 | "768x1536" |
or |
"1:2"
+
"1K"
|
| 1536 × 768 | "1536x768" |
or |
"2:1"
+
"1K"
|
| 896 × 1280 | "896x1280" |
or |
"10:14"
+
"1K"
|
| 1280 × 896 | "1280x896" |
or |
"14:10"
+
"1K"
|
| 832 × 1344 | "832x1344" |
or |
"6:10"
+
"1K"
|
| 896 × 1216 | "896x1216" |
or |
"3:4"
+
"1K"
|
| 1216 × 896 | "1216x896" |
or |
"4:3"
+
"1K"
|
| 832 × 1280 | "832x1280" |
or |
"2:3"
+
"1K"
|
| 1280 × 832 | "1280x832" |
or |
"3:2"
+
"1K"
|
| 866 × 1212 | "866x1212" |
or |
"10:14"
+
"1K"
|
| 1183 × 887 | "1183x887" |
or |
"4:3"
+
"1K"
|
| 916 × 1145 | "916x1145" |
or |
"4:5"
+
"1K"
|
| 1145 × 916 | "1145x916" |
or |
"5:4"
+
"1K"
|
| 1024 × 1024 | "1024x1024" |
or |
"1:1"
+
"1K"
|
| 887 × 1182 | "887x1182" |
or |
"3:4"
+
"1K"
|
| 724 × 1448 | "724x1448" |
or |
"1:2"
+
"1K"
|
| 1448 × 724 | "1448x724" |
or |
"2:1"
+
"1K"
|
| 793 × 1322 | "793x1322" |
or |
"6:10"
+
"1K"
|
| 836 × 1254 | "836x1254" |
or |
"2:3"
+
"1K"
|
| 1254 × 836 | "1254x836" |
or |
"3:2"
+
"1K"
|
| 768 × 1365 | "768x1365" |
or |
"9:16"
+
"1K"
|
| 1365 × 768 | "1365x768" |
or |
"16:9"
+
"1K"
|
| 1211 × 865 | "1211x865" |
or |
"14:10"
+
"1K"
|
| 768 × 1344 | "768x1344" |
or |
"9:16"
+
"1K"
|
| 896 × 1152 | "896x1152" |
or |
"4:5"
+
"1K"
|
| 1152 × 896 | "1152x896" |
or |
"5:4"
+
"1K"
|
| 1344 × 768 | "1344x768" |
or |
"16:9"
+
"1K"
|
size
Exact pixel dimensions
"1920x1080"
aspect_ratio
Shape only, default scale
"16:9"
resolution
Scale tier, preserves shape
"1K"
size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.
7:1 on a model with
4:1 and 8:1,
you get 8:1.
0.5K 1K 2K 4K)
or megapixel tiers (0.25 1).
If the exact tier isn't available, you get the nearest one.
| Parameter | Type | Description | Modes |
|---|---|---|---|
response_format
|
string |
How to return the image
url
b64_json
Default:
"url" |
T2I
|
output_format
|
string |
Output image format
png
jpeg
gif
webp
avif
Gateway converts to requested format if provider doesn't support it natively.
|
T2I
|
output_compression
|
integer | Compression level for lossy formats (JPEG, WebP, AVIF) |
T2I
|
n
|
integer |
Number of images to generate
Default:
1Gateway generates multiple images in parallel even if provider only supports 1.
|
T2I
|
| Parameter | Type | Description | Modes |
|---|---|---|---|
background_color
fal
|
object | The preferable background color of the generated images. |
T2I
|
colors
fal
|
array | An array of preferable colors |
T2I
|
enable_safety_checker
fal
|
boolean | If set to true, the safety checker will be enabled. |
T2I
|
How we handle parameters across different providers
Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:
| Behavior | What happens | Example |
|---|---|---|
passthrough |
Sent as-is to the provider | style, quality |
renamed |
Same value, mapped to the field name the provider expects | prompt |
converted |
Transformed to the provider's native format | size |
emulated |
Works even if the provider has no concept of it | n, response_format |
Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.
Recraft V4 is ranked #8 in Text-to-Image with an Elo of 1259 on the Lumenfall Arena, where real users pick the better image in blind comparisons. These rankings are based on 5 blind-vote competitions.
8 without speed data omitted.
“Vintage minimalist restaurant logo for "Caffè Florian", retro cloche dome with steam and "Est. 1720" banner, classic typography, warm brown and cream tones, subtle texture on light background, vector emblem style.”
“Vintage minimalist restaurant logo for "Caffè Florian", retro cloche dome with steam and "Est. 1720" banner, classic typography, warm brown and cream tones, subtle texture on light background, vector emblem style.”
“Close portrait of a battle-worn paladin in ornate engraved plate armor, hair braided with small beads, faint scars and dirt on the skin, warm torchlight reflecting off metal, shallow depth of field, bokeh sparks, lifelike eyes, highly detailed texture on leather straps and cloth underlayer.”
“Hyper-photorealistic scene of fluffy baby animals—a golden retriever puppy, tabby kitten, baby bunny, and red fox kit—with big expressive eyes and ultra-detailed soft fur, playfully chasing butterflies and tumbling together in a lush wildflower meadow, warm golden sunrise light with god rays and dew sparkles, joyful wholesome vibe, 8K masterpiece.”
“Create a clear, 45° top-down isometric miniature 3D cartoon scene of Japan's signature dish: sushi, with soft refined textures, realistic PBR materials, gentle lighting, on a small raised diorama base with minimal garnish and plate. Solid light blue background. At top-center: 'JAPAN' in large bold text, 'SUSHI' below it, small flag icon. Perfectly centered, ultra-clean, high-clarity, square format.”
“Hyper-photorealistic full-body portrait of a female superhero standing triumphantly on a New York skyscraper rooftop at golden sunset, wearing a classic modest superhero costume with flowing cape, chest emblem, gloves, and boots in red and blue colors, practical design, short hair, strong determined heroic expression looking into the distance, powerful confident stance with hands on hips and cape billowing dramatically in the wind, detailed urban cityscape background, warm natural sunlight with sharp shadows and fabric highlights, ultra-sharp textures on suit, hair, and concrete, 8K masterpiece, empowering family-friendly style.”
Recraft V4 starts at $0.04 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
You can use Recraft V4 through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "recraft-v4". Code examples are available in Python, JavaScript, and cURL.
Recraft V4 is available through fal.ai and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.
Recraft V4 supports images up to 1536x1536 resolution.
Recraft V4 is a text-to-image foundation model developed by Recraft AI that focuses on high-fidelity graphic design and vector-like precision. It distinguishes itself from general-purpose artistic generators by prioritizing spatial control, text rendering accuracy, and the ability to strictly adhere to user-defined brand assets like specific color palettes.
Recraft V4 is built on a transformer-based architecture optimized for high-resolution image synthesis. Unlike models trained solely on aesthetic internet scrapes, Recraft’s training pipeline emphasizes structural understanding and graphic design principles, allowing the model to treat design elements as discrete, manageable components.
Recraft V4 is ideal for professional workflows including logo design, detailed vector-style illustrations, and marketing collateral where brand consistency is non-negotiable. Its ability to handle precise text makes it a strong candidate for UI/UX mockups and infographics. This model is available for testing and deployment through Lumenfall’s unified API and playground, allowing developers to integrate high-quality design generation into their applications with a single integration point.
Generate images with custom prompts — no API key needed.
