Skip to content

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.

API model IDrecraft/recraft-v4-1
A single patent-leather skate stands on a pale mint sweep, with cream laces and coral wheels.
Cherry-red roller skateA single patent-leather skate stands on a pale mint sweep, with cream laces and coral wheels.

Best for

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 · Required

    What to generate, 1 to 10000 characters.

    1–10000 characters

  • sizestring

    An 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_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.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