“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.”
Recraft's latest image generation model at ~2048px resolution with stronger composition, refined lighting, and realistic materials for print-ready and large-scale work
Details
recraft-v4-pro
Starting from
Prices shown are in USD
See all providersProvider Performance
Fastest generation through replicate at 35,650ms median latency with 100.0% success rate.
Aggregated from real API requests over the last 30 days.
Generation Time
Success Rate
Time to First Byte
Provider Rankings
| # | Provider | p50 Gen Time | p95 Gen Time | Success Rate | TTFB (p50) |
|---|---|---|---|---|---|
| 1 | replicate | 35,650ms | 53,333ms | 100.0% | 35,785ms |
Providers & Pricing (2)
Recraft V4 Pro is available from 2 providers, with per-image pricing starting at $0.25 through fal.ai.
fal/recraft-v4-pro
replicate/recraft-v4-pro
Recraft V4 Pro API OpenAI-compatible
Integrate Recraft V4 Pro into your workflow via the Lumenfall OpenAI-compatible API to generate print-ready, high-resolution imagery from text prompts.
https://api.lumenfall.ai/openai/v1
recraft-v4-pro
Code Examples
Text to Image
/v1/images/generationscurl -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-pro",
"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-pro',
prompt: '',
size: '1024x1024'
});
// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.lumenfall.ai/openai/v1"
)
response = client.images.generate(
model="recraft-v4-pro",
prompt="",
size="1024x1024"
)
# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)
Parameter Reference
Core Parameters
| Parameter | Type | Description | Modes |
|---|---|---|---|
prompt
|
string | Required. Text prompt for image generation |
T2I
|
Size & Layout
| 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
2K
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 |
1K 14 sizes
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| 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"
|
2K 14 sizes
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| 1536 × 3072 | "1536x3072" |
or |
"1:2"
+
"2K"
|
| 3072 × 1536 | "3072x1536" |
or |
"2:1"
+
"2K"
|
| 1792 × 2560 | "1792x2560" |
or |
"10:14"
+
"2K"
|
| 2560 × 1792 | "2560x1792" |
or |
"14:10"
+
"2K"
|
| 1664 × 2688 | "1664x2688" |
or |
"6:10"
+
"2K"
|
| 1792 × 2432 | "1792x2432" |
or |
"3:4"
+
"2K"
|
| 2432 × 1792 | "2432x1792" |
or |
"4:3"
+
"2K"
|
| 1664 × 2560 | "1664x2560" |
or |
"2:3"
+
"2K"
|
| 2560 × 1664 | "2560x1664" |
or |
"3:2"
+
"2K"
|
| 2048 × 2048 | "2048x2048" |
or |
"1:1"
+
"2K"
|
| 1536 × 2688 | "1536x2688" |
or |
"9:16"
+
"2K"
|
| 1792 × 2304 | "1792x2304" |
or |
"4:5"
+
"2K"
|
| 2304 × 1792 | "2304x1792" |
or |
"5:4"
+
"2K"
|
| 2688 × 1536 | "2688x1536" |
or |
"16:9"
+
"2K"
|
How these parameters work
size
Exact pixel dimensions
"1920x1080"
aspect_ratio
Shape only, default scale
"16:9"
resolution
Scale tier, preserves shape
"1K"
Priority when combined
size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.
How matching works
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.
Output & Format
| 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
|
Additional Parameters
| 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
|
Parameter Normalization
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 Pro Benchmarks
Recraft V4 Pro is ranked #11 in Text-to-Image with an Elo of 1251 on the Lumenfall Arena, where real users pick the better image in blind comparisons. These rankings are based on 5 blind-vote competitions.
Text-to-Image Landscape
Elo vs Cost
Elo vs Speed
8 without speed data omitted.
Competition Results
“A candid street photo of an elderly Japanese man repairing a red bicycle in light rain, reflections on wet pavement, shallow depth of field, 50mm lens, natural skin texture, imperfect framing, motion blur from passing cars, cinematic but realistic, no stylization.”
“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.”
Uncategorized
“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.”
“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.”
Use Cases
See all Use CasesGallery
View all 9 imagesRecraft V4 Pro FAQ
How much does Recraft V4 Pro cost?
Recraft V4 Pro starts at $0.25 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Recraft V4 Pro via API?
You can use Recraft V4 Pro through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "recraft-v4-pro". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Recraft V4 Pro?
Recraft V4 Pro is available through fal.ai and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.
What is the maximum resolution for Recraft V4 Pro?
Recraft V4 Pro supports images up to 3072x3072 resolution.
Overview
Recraft V4 Pro is a high-resolution text-to-image model developed by Recraft AI, specifically designed for professional-grade graphic design and print-ready digital art. Unlike many foundation models that focus primarily on photorealism, Recraft V4 Pro prioritizes spatial composition, complex text rendering, and material accuracy at resolutions up to 2048px. It is characterized by its ability to follow long, intricate prompts while maintaining anatomical and structural consistency.
Strengths
- Exact Text Rendering: The model demonstrates high accuracy when generating specific strings of text within images, making it suitable for logo design, posters, and UI mockups.
- Material and Texture Fidelity: It excels at simulating physical properties such as the specularity of metal, the translucency of glass, and the tactile nature of various fabrics.
- Compositional Control: V4 Pro handles complex scene layouts better than earlier iterations, accurately placing multiple objects in relation to one another as defined in the prompt.
- Vector-Like Precision: Although it outputs raster images, the model generates sharp edges and clean color separations that mimic the aesthetic of professional vector software and high-end digital illustration.
Limitations
- Prompt Sensitivity: To achieve the highest level of detail in large-scale prints, the model often requires more descriptive prompting regarding lighting and material types compared to “one-click” consumer models.
- Inference Speed: Due to its high output resolution (~2048px) and focus on structural integrity, it may have higher latency than smaller, distilled models optimized for rapid iteration.
- Stylized Bias: While capable of photorealism, the model’s default “cleanliness” can sometimes lean toward a polished commercial aesthetic that may require specific negative prompting for more “gritty” or lo-fi artistic styles.
Technical Background
Recraft V4 Pro is an evolution of Recraft’s proprietary architecture, optimized for high-resolution 2K outputs without the artifacts often seen in tiled upscaling or standard latent diffusion. The training methodology emphasizes alignment with design-centric datasets, focusing on spatial relationships and typographical accuracy. It utilizes a refined lighting system that calculates shadows and reflections based on object geometry rather than simple texture overlays.
Best For
This model is best suited for professional designers creating print-ready assets, brand identities, and commercial illustrations where precise text and high-resolution details are non-negotiable. It is an excellent choice for generating marketing collateral, detailed product concepts, and complex icon sets. Recraft V4 Pro is available for testing and integration through Lumenfall’s unified API and interactive playground, allowing developers to compare its output alongside other industry-leading image models.
Try Recraft V4 Pro in Playground
Generate images with custom prompts — no API key needed.