
Output
image
Aspect ratio
1:1, 16:9, 9:16, 4:3, 3:4
Resolution
1024, 2048, 4096
Example prompt
An epic fantasy battle scene painted in the style of a vintage book cover illustration — a lone armored knight on horseback charging through a shattered stained-glass portal into a realm of swirling crimson storm clouds and floating obsidian islands, twin dragons silhouetted against twin moons, ultra detailed armor engravings, rich jewel-toned color palette, dynamic diagonal composition, painterly brushwork texture, cinematic scale, 8K resolutionTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/recraft/v4/pro/text-to-image.
POST
/api/v1/generate12 fields · 2 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Required | Optional model input. |
colors | object | Optional | An array of preferable colors, e.g. [{"r":255,"g":0,"b":0}] |
background_color | object | Optional | Preferable background color as an RGB object, e.g. {"r":255,"g":255,"b":255} |
enable_safety_checker | boolean | Optional | If set to true, the safety checker will be enabled. · Default: true |
aspect_ratio | string | Optional | Allowed: 1:1, 16:9, 9:16, 4:3, 3:4 |
resolution | string | Optional | Allowed: 1024, 2048, 4096 |
Minimal request example
{
"model_id": "fal-ai/recraft/v4/pro/text-to-image",
"prompt": "An epic fantasy battle scene painted in the style of a vintage book cover illustration — a lone armored knight on horseback charging through a shattered stained-glass portal into a realm of swirling crimson storm clouds and floating obsidian islands, twin dragons silhouetted against twin moons, ultra detailed armor engravings, rich jewel-toned color palette, dynamic diagonal composition, painterly brushwork texture, cinematic scale, 8K resolution"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv4%2Fpro%2Ftext-to-image",
"title": "Recraft v4 Pro generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/pro/text-to-image.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/recraft/v4/pro/text-to-image",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string"
},
"colors": {
"title": "Colors",
"description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
"type": "object",
"additionalProperties": true
},
"background_color": {
"title": "Background Color",
"description": "Preferable background color as an RGB object, e.g. {\"r\":255,\"g\":255,\"b\":255}",
"type": "object",
"additionalProperties": true
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "If set to true, the safety checker will be enabled.",
"default": true,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4"
]
},
"resolution": {
"type": "string",
"enum": [
"1024",
"2048",
"4096"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}FAQ
How much does Recraft v4 Pro cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if Recraft v4 Pro fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Recraft v4 Pro from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/recraft/v4/pro/text-to-image". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with Recraft v4 Pro?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.