Skip to main content
RecraftMediumHigh

Recraft V4.1

Recraft's latest image generation model, built around design taste โ€” strong prompt accuracy, art-directed composition and integrated text rendering at standard (~1MP) resolution.

93 credits
per image
Design-first composition with strong prompt accuracy
Integrated text rendering for headlines and labels
Wide range of styles from photography to illustration
15 aspect ratio presets or 14 exact pixel sizes
Long prompts up to 10,000 characters

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "prompt": "A brutalist concrete library interior at golden hour โ€” shafts of amber light cut through narrow slit windows and fall across tiered balconies lined with thousands of identical navy-blue hardcover books. A single reader sits far below in a pool of direct light. Wide-angle tilt-shift lens from above, architectural photography.",
    "aspect_ratio": "Not set",
    "size": "1024x1024"
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
promptstringYes-Text prompt for image generation (up to 10,000 characters)
aspect_ratiostringNoNot setAspect ratio of the generated image. When set, size is ignored
Not set1:14:33:43:22:316:99:161:22:114:1010:144:55:46:10
sizestringNo1024x1024Width and height of the generated image. Size is ignored if an aspect ratio is set.
1024x10241536x768768x15361280x832832x12801216x896896x12161152x896896x1152832x13441280x896896x12801344x768768x1344

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Architectural photography

Art-directed interior scene at the default 1024x1024 size

Architectural photography
curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "prompt": "A brutalist concrete library interior at golden hour โ€” shafts of amber light cut through narrow slit windows and fall across tiered balconies lined with thousands of identical navy-blue hardcover books. A single reader sits far below in a pool of direct light. Wide-angle tilt-shift lens from above, architectural photography.",
    "aspect_ratio": "Not set",
    "size": "1024x1024"
  }
}'

Social banner with text

Wide banner using an aspect ratio preset

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "recraft-ai/recraft-v4.1",
  "input": {
    "prompt": "A clean flat-design banner for a coffee shop spring promotion with the headline 'Spring Blend' in bold serif type, pastel palette",
    "aspect_ratio": "16:9"
  }
}'

Tips & Best Practices

1Set aspect_ratio for common ratios; leave it 'Not set' and use size for exact pixel dimensions
2Put the exact text you want rendered in quotes inside the prompt
3Use Recraft V4.1 Pro for ~2048px print-ready output, or the SVG variants for vector files
4Each call returns one image at a flat 93 credits regardless of size

Use Cases

Marketing and social media visuals with on-image text
Editorial and architectural imagery
Brand and design exploration at low cost
Blog and landing-page hero images