Recraft 4.1 Text to Image is Recraft's text-to-image model on Versely. This page is its structured prompting reference: the 2 parameters its schema actually exposes, the t2i technique that applies to it, copy-ready templates.
Everything here is grounded in the same sources Versely's agent reads — the model's input schema. Where a line is general craft advice rather than a documented fact about Recraft 4.1 Text to Image, the page says so.
What Recraft 4.1 Text to Image wants
The exact input surface, from the same schema the Versely agent fetches with get_model_input_schema before every generation.
| Parameter | What it does | Values |
|---|---|---|
promptreq | Text description for image generation (1-10000 chars) | string (min 1, max 10000) |
image_size | Output size preset, OR pass an object { width: 1-14142, height: 1-14142 } for custom dimensions | square_hd · square · portrait_4_3 · portrait_16_9 · landscape_4_3 · landscape_16_9default: square_hd |
- — Verified against fal.ai/models/fal-ai/recraft/v4.1/text-to-image on 2026-05-19
Technique that applies here
Text-to-image: composition, lighting, style; family tips (Midjourney/Flux/Imagen/etc.) drive syntax
- Versely's AI-enhance step (POST /features/generate-prompt, the same enhancer the enhance_prompt agent tool calls) targets a 50-150 word image prompt and explicitly instructs Gemini to cover subject, environment/setting, lighting, mood/atmosphere, color palette, composition, and artistic style. That's a solid checklist to hit by hand even if you skip the enhancer.
- Qwen Image (+ Qwen Z Image), GPT Image 2, Nano Banana, Cosmos 3 Super, Krea 2 Medium, Grok Imagine Image, Recraft 4.1, and ImagineArt 2.0 aren't in that 12-family list, so they fall back to the enhancer's generic default: 'vivid, specific descriptions with details about composition, lighting, style, and atmosphere.' No model-specific syntax is being layered on for you on these — be explicit yourself about subject, setting, lighting, style, and mood.
- Pick aspect ratio / size from the model's actual enum rather than describing it in prose. Cosmos 3 Super and Recraft 4.1 both take the same six image_size presets (square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9); Flux 2 Max's resolved schema takes that same six plus a 7th value, auto; Seedream 4.0 uses the six-preset list too, plus a custom {width, height} object (960-4096px, ~2048x2048 default); Grok Imagine Image Quality and Krea 2 Medium instead take an aspect_ratio string enum (Krea's list includes a 2.35:1 cinematic option Grok's doesn't have).
Copy-ready templates
Replace the bracketed slots; each template says when it's the right shape.
[SUBJECT], [ACTION OR POSE], in [SETTING/ENVIRONMENT], [LIGHTING] lighting, [COLOR PALETTE], [STYLE OR MEDIUM], [MOOD/ATMOSPHERE]. (Pick aspect ratio/size from the model's own preset field — the schema takes an enum value, not a ratio typed into the prompt.)
Use when: Starting from nothing on any model in this family — no reference image, one self-contained generation.
[SUBJECT], [ARTISTIC REFERENCE — artist, movement, or genre], [LIGHTING DESCRIPTOR, e.g. volumetric lighting / golden hour], [MEDIUM DESCRIPTOR, e.g. oil painting / 35mm photograph / digital art], [COLOR PALETTE], [MOOD]
Use when: On Midjourney V7 or Niji 6, whose MODEL_TIPS calls for comma-separated descriptors over full sentences.
How the Versely agent does this automatically
You can use this page by hand, or let the agent apply the same knowledge. Four real mechanisms — no more, no less:
get_model_input_schema— before generating, the agent looks up Recraft 4.1 Text to Image's exact input fields, required fields, allowed values, defaults, and min/max bounds. The parameter table above is that same surface.- The prompt enhancer's family rules — 12 per-family rewrite rules (this model's family isn't one of the 12, so only general enhancement applies) shape how a rough prompt gets rewritten.
- The per-provider speech guide — for TTS scripts, the agent follows a provider-specific tag scheme — not relevant to this model, but it's why voiceover scripts come out marked up correctly.
expand_movie_scene— in movie flows, brief scene ideas are rewritten into detailed cinematic descriptions before generation.
Mistakes that waste generations
- Padding every prompt with quality-booster tag lists ("masterpiece, best quality, highly detailed, 8k"). That convention belongs to the 'stable' MODEL_TIPS family — comma-separated tags plus quality boosters — and nothing in this family resolves to it; on Flux, Imagen, Midjourney, or any of the fallback-tip models it just reads as filler the model has to parse around.
- Free-typing an aspect ratio or size string outside the model's real enum — e.g. asking for 'a wide 2.5:1 banner' on a model whose aspect_ratio list tops out at 21:9, or writing 'widescreen' where the field wants the literal preset value landscape_16_9. The schema enum is exact; the model isn't interpreting loose ratio language.
- Writing an edit instruction ("make the sky sunset-orange") into one of the plain-generation pages that also covers an edit-capable gate variant (Flux 2 Max/Pro Edit, Nano Banana Edit, GPT Image 2 Image to Image, Wan 2.6 Image to Image) without attaching a reference image. With no image_urls supplied, you get a brand-new unrelated image, not an edit of anything.
This guide also covers
These siblings share Recraft 4.1 Text to Image's prompting-relevant input surface, so their prompting URLs resolve here — tier and pricing differences live on their own model pages:
Frequently asked questions
How long can a Recraft 4.1 Text to Image prompt be?+
Recraft 4.1 Text to Image's schema caps the prompt at 10,000 characters. Spend them on the subject, motion, and the register its family rewards rather than restating parameters the schema already controls.
Does Recraft 4.1 Text to Image support negative prompts?+
No — Recraft 4.1 Text to Image's published schema has no negative_prompt parameter. Exclusions have to be phrased positively inside the main prompt, or dropped.
How does the Versely agent know Recraft 4.1 Text to Image's parameters?+
Before generating, the agent calls its get_model_input_schema tool, which looks up the exact input fields, required fields, allowed values, defaults, and min/max bounds for the model. Nothing on this page is guessed — it is the same schema surface those tools read.
Does this guide also cover Recraft V4 and Recraft 4 Text to Image?+
Yes. Recraft V4, Recraft 4 Text to Image share the same prompting-relevant input surface as Recraft 4.1 Text to Image, so their prompting URLs redirect here instead of duplicating this page. Tier and pricing differences live on each model's own /models page.
Related prompting guides
Generate with Recraft 4.1 Text to Image
Recraft 4.1 Text to Image is live in Versely — paste a template above, or just describe what you want and let the agent map it onto the schema for you.