Recraft
Recraft V4.1
Create a 1K raster image from a brief. A palette, background color and style references help a series share an art direction.
recraft/recraft-v4-1Best for
- Explore cover art in a chosen palette
- Build a series of editorial illustrations from the same references
More examples
Technical details
Read the model documentation- API model ID
recraft/recraft-v4-1- Provider
- Recraft
- Modality
- Image
- Input
- Text prompt · Images
- Output
- Image
- Endpoint
POST /v2/jobs- Workflow
- Text to image
Request parameters
promptstring · RequiredWhat to generate, 1 to 10000 characters.
1–10000 characters
sizestringAn aspect ratio such as `16:9` or an exact 1K size such as `1024x1024`; when omitted, one is picked from the prompt.
- 1:1
- 2:1
- 1:2
- 3:2
- 2:3
- 4:3
- 3:4
- 5:4
- 4:5
- 6:10
- 14:10
- 10:14
- 16:9
- 9:16
- 1024x1024
- 1536x768
- 768x1536
- 1280x832
- 832x1280
- 1216x896
- 896x1216
- 1152x896
- 896x1152
- 832x1344
- 1280x896
- 896x1280
- 1344x768
- 768x1344
image_formatstringThe raster format of the result: `webp` (lossless, the default) or `png`; a vector result is always SVG.
- webp
- png
controlsobjectColor preferences for the result: `colors` (up to 10) and `background_color`.
controls.background_colorobjectThe preferable background color.
Additional parameters
controls.background_color.rgbarray · Required with controls.background_colorThe color as three whole numbers from 0 to 255: red, green, blue.
3–3 items
controls.background_color.stdarrayThe spread of the color around `rgb`, one number per channel (the vendor's `std`); it does not change the price.
controls.background_color.weightnumberSet the relative preference for the background color with a number from 0 to 1.
0–1
controls.colorsarraySuggest up to 10 colors. Each palette entry requires an rgb array of exactly three integers from 0 to 255, in red, green, blue order.
Up to 10 items
- To weight the palette, give every color a weight between 0 and 1. The weights may add up to at most 1. To leave the palette unweighted, omit weight from every color.
- An optional std array gives the color spread as one number per RGB channel. The API publishes no numeric bounds for std.
random_seedintegerRandom seed, a whole number from 0 to 4294967295; set it for reproducible generation.
0–4294967295
style_idstringThe id (a UUID) of a style to generate in: a public or shared style of the same model, or one an earlier request made from `style_reference_urls`;
- it cannot be combined with `style_reference_urls`.
style_matchstringHow closely the result follows the style: `flexible` or `precise`; when omitted, the style's own setting applies.
- flexible
- precise
style_reference_urlsarray1 to 10 public https URLs of PNG, JPEG or WEBP images whose style the result borrows (64 MB in total);
1–10 items
- a job does not return the `style_id` of the style they make;
- the references are priced once per request.
zdrbooleanWhen enabled, Recraft skips logging or storing your prompt and reference images. Recraft still stores the output to serve its URL. ZDR adds no charge.
Pricing
| Billable unit and options | Rate (USD) |
|---|---|
| Per image | $0.035 |
| Style references, once per requestadded to the per-image price of the request | $0.005 |
Billing notes
- Billed per image delivered; n multiplies the price.
Catalogue rates on 21 Nov 2026. Prices exclude VAT.
View in pricing catalogue


