Image

Recraft v4

Credit-based pricing.

Try Recraft v4 →Compare models

Output

image

Aspect ratio

1:1, 16:9, 9:16, 4:3, 3:4

Resolution

1024, 2048

Example prompt

An imposing gothic cathedral carved entirely from black obsidian rising from a frozen arctic tundra under the aurora borealis, intricate stone gargoyles dusted with fresh snow, pale moonlight casting long shadows across ice-covered steps, glowing stained glass windows in deep emerald and violet, ultra detailed architecture, cinematic wide-angle shot, 8K resolution

Try 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/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

Minimal request example

{
  "model_id": "fal-ai/recraft/v4/text-to-image",
  "prompt": "An imposing gothic cathedral carved entirely from black obsidian rising from a frozen arctic tundra under the aurora borealis, intricate stone gargoyles dusted with fresh snow, pale moonlight casting long shadows across ice-covered steps, glowing stained glass windows in deep emerald and violet, ultra detailed architecture, cinematic wide-angle shot, 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%2Ftext-to-image",
  "title": "Recraft v4 generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v4/text-to-image.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/recraft/v4/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"
      ]
    }
  },
  "required": [
    "model_id",
    "prompt"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Recraft v4 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 fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Recraft v4 from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/recraft/v4/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?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.