# Recraft V4.1

`recraft/recraft-v4-1` · Recraft · image

Create a 1K raster image from a brief. A palette, background color and style references help a series share an art direction.

[Model page](https://sociaro.com/models/recraft/recraft-v4-1) · [JSON](https://sociaro.com/models/recraft/recraft-v4-1.json) · [Model pricing](https://sociaro.com/pricing?model=recraft%2Frecraft-v4-1) · [Documentation](https://docs.sociaro.com/models/recraft-recraft-v4-1/) · [Playground](https://my.sociaro.com/playground/?model=recraft/recraft-v4-1)

## Use cases

- Explore cover art in a chosen palette
- Build a series of editorial illustrations from the same references

## Technical details

- 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

- `prompt` (string, required) — What to generate, 1 to 10000 characters.
  - 1–10000 characters
- `image_format` (string) — The raster format of the result: `webp` (lossless, the default) or `png`; a vector result is always SVG.
  - Allowed values — `webp`, `png`
- `random_seed` (integer) — Random seed, a whole number from 0 to 4294967295; set it for reproducible generation.
  - 0–4294967295
- `controls` (object) — Color preferences for the result: `colors` (up to 10) and `background_color`.
- `controls.colors` (array) — Suggest 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.
- `controls.background_color` (object) — The preferable background color.
- `controls.background_color.rgb` (array, required with `controls.background_color`) — The color as three whole numbers from 0 to 255: red, green, blue.
  - 3–3 items
- `controls.background_color.std` (array) — The spread of the color around `rgb`, one number per channel (the vendor's `std`); it does not change the price.
- `controls.background_color.weight` (number) — Set the relative preference for the background color with a number from 0 to 1.
  - 0–1
- `size` (string) — An aspect ratio such as `16:9` or an exact 1K size such as `1024x1024`; when omitted, one is picked from the prompt.
  - Allowed values — `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`
- `style_id` (string) — The 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_reference_urls` (array) — 1 to 10 public https URLs of PNG, JPEG or WEBP images whose style the result borrows (64 MB in total); a job does not return the `style_id` of the style they make; the references are priced once per request.
  - 1–10 items
- `style_match` (string) — How closely the result follows the style: `flexible` or `precise`; when omitted, the style's own setting applies.
  - Allowed values — `flexible`, `precise`
- `zdr` (boolean) — When 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

Rates in USD. Catalogue timestamp 2026-11-21T02:23:44Z.

- USD 0.035 per image · active
- USD 0.005 style references, once per request · active · added to the per-image price of the request

- Billed per image delivered; n multiplies the price.

## Examples

### Cherry-red roller skate

A single patent-leather skate stands on a pale mint sweep, with cream laces and coral wheels.

[Result (image)](https://previews.sociaro.com/shared/promo/gallery/creative/roller-skate.webp)

### Studio presenter

A woman with a dark bob faces the camera in a saffron jacket against a fuchsia studio backdrop.

[Result (image)](https://previews.sociaro.com/shared/promo/gallery/alibaba-video/wan-studio-presenter-portrait.png)

1280 × 832

### Profile in orange

Orange glasses and a metallic jacket stand out against a saturated blue backdrop.

[Result (image)](https://previews.sociaro.com/shared/promo/catalog/recraft-portrait.webp)

### Vermilion stairs

A pedestrian crosses a red staircase beneath a cobalt sky.

[Result (image)](https://previews.sociaro.com/shared/promo/catalog/recraft-architecture.webp)
