Skip to content

Recraft

Recraft V4.1 Pro

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

API model IDrecraft/recraft-v4-1-pro
A translucent chartreuse chair casts rippled light across a violet floor.
Glass in violet lightA translucent chartreuse chair casts rippled light across a violet floor.

Best for

Technical details

Read the model documentation
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

  • promptstring · Required

    What to generate, 1 to 10000 characters.

    1–10000 characters

  • sizestring

    Choose an aspect ratio or one of the exact 2K sizes. Omit size to let the prompt determine the image shape.

    • 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
  • image_formatstring

    The raster format of the result: `webp` (lossless, the default) or `png`; a vector result is always SVG.

    • webp
    • png
  • controlsobject

    Color preferences for the result: `colors` (up to 10) and `background_color`.

  • controls.background_colorobject

    The preferable background color.

Additional parameters

  • controls.background_color.rgbarray · Required with controls.background_color

    The color as three whole numbers from 0 to 255: red, green, blue.

    3–3 items

  • controls.background_color.stdarray

    The spread of the color around `rgb`, one number per channel (the vendor's `std`); it does not change the price.

  • controls.background_color.weightnumber

    Set the relative preference for the background color with a number from 0 to 1.

    0–1

  • controls.colorsarray

    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.
  • random_seedinteger

    Random seed, a whole number from 0 to 4294967295; set it for reproducible generation.

    0–4294967295

  • style_idstring

    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_matchstring

    How closely the result follows the style: `flexible` or `precise`; when omitted, the style's own setting applies.

    • flexible
    • precise
  • style_reference_urlsarray

    1 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.
  • zdrboolean

    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

Billable unit and optionsRate (USD)
Per image$0.21
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