# Recraft V4.1 Pro

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

Generate a 2K raster image with room for finer texture and tighter crops. Steer the lighting and materials with a palette or style references.

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

## Use cases

- Make a detailed lead image for a campaign
- Create artwork that will also be cropped for close-ups

## Technical details

- API model ID — recraft/recraft-v4-1-pro
- 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) — Choose an aspect ratio or one of the exact 2K sizes. Omit size to let the prompt determine the image shape.
  - 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`, `2048x2048`, `3072x1536`, `1536x3072`, `2560x1664`, `1664x2560`, `2432x1792`, `1792x2432`, `2304x1792`, `1792x2304`, `1664x2688`, `2560x1792`, `1792x2560`, `2688x1536`, `1536x2688`
- `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.21 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

### Glass in violet light

A translucent chartreuse chair casts rippled light across a violet floor.

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

### Through the visor

A silver visor reflects the studio lights beneath a sculptural lime hood.

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

### Orange ear cushions

Glossy black headphones stand against a burgundy backdrop.

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