Recraft AI's premium text-to-vector model for generating detailed SVG vector graphics with refined composition and materials
Details
recraft-v4-pro-svg
Starting from
Prices shown are in USD
See all providersProviders & Pricing (2)
Recraft V4 Pro SVG is available from 2 providers, with per-image pricing starting at $0.3 through fal.ai.
fal/recraft-v4-pro-svg
replicate/recraft-v4-pro-svg
Recraft V4 Pro SVG API OpenAI-compatible
Integrate Recraft V4 Pro SVG into your workflow via the Lumenfall OpenAI-compatible API to programmatically generate scalable vector graphics and professional text-to-image illustrations.
https://api.lumenfall.ai/openai/v1
recraft-v4-pro-svg
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-svg", "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-svg', 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-pro-svg", 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.
Gallery
View all 4 imagesRecraft V4 Pro SVG FAQ
How much does Recraft V4 Pro SVG cost?
Recraft V4 Pro SVG starts at $0.3 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Recraft V4 Pro SVG via API?
You can use Recraft V4 Pro SVG through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "recraft-v4-pro-svg". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Recraft V4 Pro SVG?
Recraft V4 Pro SVG is available through fal.ai and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.
Overview
Recraft V4 Pro SVG is a specialized text-to-vector model developed by Recraft AI designed to generate scalable vector graphics (SVGs) directly from natural language prompts. Unlike standard diffusion models that produce rasterized pixel data, this model outputs clean, path-based geometry suitable for professional design workflows. It is distinctive for its ability to handle complex compositions and material simulations while maintaining the mathematical editability inherent to the SVG format.
Strengths
- Vector Fidelity: Generates true path-based SVG files rather than vectorized versions of raster images, resulting in clean anchor points and scalable curves without resolution loss.
- Refined Material Logic: Excels at interpreting prompts for specific artistic materials and textures, translating them into vector-compatible gradients and shapes.
- Complex Compositional Awareness: Maintains high spatial accuracy when managing multiple subjects or intricate layouts, reducing the likelihood of overlapping or nonsensical pathing.
- Design Workflow Integration: Produces output that is natively compatible with professional tools like Adobe Illustrator and Figma, allowing for immediate manual adjustment of individual points and layers.
Limitations
- Photorealism Constraints: Due to the nature of vector graphics, this model is not intended for generating photorealistic human faces or complex organic textures that require high-frequency pixel detail.
- Path Complexity: Extremely detailed prompts can lead to very large SVG files with thousands of paths, which may slow down performance in certain vector editing software.
- Text Encoding: While it handles graphic layouts well, it may still struggle with rendering precise, high-character-count strings of text within the generated vector artwork.
Technical Background
The Recraft V4 architecture is built on a private foundation model specifically optimized for geometric and structural understanding rather than just pixel-level distribution. It utilizes a training approach that prioritizes the relationship between semantic descriptions and vector path logic, ensuring that the generated geometry is organized logically into groups and layers. This allows the model to produce “clean” code that mirrors the output of a human graphic designer more closely than a standard automated tracer.
Best For
Recraft V4 Pro SVG is ideal for UI/UX designers creating iconography systems, brand identity designers developing logos and illustrations, and web developers who need lightweight, scalable assets for responsive interfaces. It is particularly effective for any use case requiring assets that must be scaled infinitely without pixelation.
This model is available through Lumenfall’s unified API and interactive playground, allowing developers to integrate high-quality vector generation into their existing application pipelines with minimal configuration.
Try Recraft V4 Pro SVG in Playground
Generate images with custom prompts — no API key needed.