Recraft's V4.1 standard tier text-to-image model — refines V4's photorealism with more natural lighting, softer gradients, and sharper illustration styles for everyday creative work
Details
recraft-v4.1
Starting from
Prices shown are in USD
Full pricing detailsProviders & Pricing (1)
Recraft V4.1 is available exclusively through fal.ai, starting at $0.04/image.
recraft-v4-1 API OpenAI-compatible
https://api.lumenfall.ai/openai/v1
recraft-v4.1
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.1", "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.1', 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.1", 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")
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
|
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
Provider-specific passthrough fields, available only when the request is routed to the listed provider.
| Parameter | Type | Description | Modes |
|---|---|---|---|
|
fal
|
|||
background_color
|
["object", "null"] | The preferable background color of the generated images, as an `{r, g, b}` object with channel values 0-255. |
T2I
|
colors
|
array | An array of preferable colors. Each entry is an `{r, g, b}` object with channel values 0-255. |
T2I
|
enable_safety_checker
|
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.
Gallery
View all 4 imagesRecraft V4.1 FAQ
How much does Recraft V4.1 cost?
Recraft V4.1 starts at $0.04 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Recraft V4.1 via API?
You can use Recraft V4.1 through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "recraft-v4.1". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Recraft V4.1?
Recraft V4.1 is available through fal.ai on Lumenfall. Lumenfall automatically routes requests to the best available provider.
What is the maximum resolution for Recraft V4.1?
Recraft V4.1 supports images up to 1536x1536 resolution.
Try Recraft V4.1 in Playground
Generate images with custom prompts — no API key needed.