Recraft Image Generation and Editing API

Learn the basics of the Recraft API, including raster and vector image generation, style creation, image generation in your brand style and colors, image vectorization, and background removal.

Features

Styles

A style is a descriptor that defines the visual appearance and feel of generated images. This includes a wide array of elements such as textures and visual effects, shapes and colors, composition and lines, etc. There are four classes of base styles: realistic image, digital illustration, vector illustration, and icon.

Realistic

Images of style “realistic” are expected to look like just ordinary photographs made with a digital camera or a smartphone or a film camera.

Digital illustration

Images of style “digital illustration” are pictures drawn by hand or using computers - virtually everything except photos and vector illustrations. The most crucial difference from “realistic images” is that illustrations possess simplified textures (like in 3D-rendered or manually drawn images) - or they are stylized in a certain creative way. The difference from “vector illustration” is that “digital illustrations” allow for more complex color transitions, shades, and fine textures.

Vector illustration

Images of style “vector illustration” are expected to look like those drawn using vector graphics (see Wikipedia). Usually, they use only a few different colors at once, shapes are filled with flat colors or simple color gradients. Shapes of objects can be arbitrarily complex.

Icon

Images of style “icon” are small digital images or symbols used in the graphical user interface. They are designed to be simple and recognizable at small sizes, often visually summarizing the action or object they stand for, or they can act as the visual identity for an app or a website and are crucial in branding.

A style can be refined by adding a substyle for more precise definition. Below, you will find a list of supported styles and corresponding substyles. Please note that the available styles and substyles may vary depending on the model. Additionally, you have an option to create your own style by combining a base style (e.g., realistic image, digital illustration, vector illustration, or icon) with a collection of reference images.

Auxiliary

Controls

The generation process can be adjusted with a number of tweaks.

Parameter	Type	Description
`artistic_level`	integer or null	Defines the artistic tone of your image. At a simple level, the person looks straight at the camera in a static and clean style. Dynamic and eccentric levels introduce movement and creativity. The value should be in the range [0..5].
`colors`	array of color definitions	An array of preferable colors.
`background_color`	color definition	Use the given color as a desired background color.
`no_text`	bool	Do not embed text layouts.

Colors

The Color type is defined as an object with the following fields:

Field	Description
`rgb` (required)	An array of 3 integer values in the range of 0...255 defining the RGB Color Model.

Example:

'controls': {
    'colors': [
        {'rgb': [0, 255, 0]}
    ]
}

Text Layout

Text layout is used to define spatial and textual attributes for individual text elements. Each text element consists of an individual word and its bounding box (bbox).

Attribute	Description
`text` (required)	A single word containing only supported characters.
`bbox` (required)	A bounding box representing a 4-angled polygon. Each point in the polygon is defined by relative coordinates.

Bounding Box: The bounding box (bbox) is a list of 4 points representing a 4-angled figure (not necessarily a rectangle). Each point specifies its coordinates relative to the layout dimensions, where (0, 0) is the top-left corner, and (1, 1) is the bottom-right corner.

Coordinates: Coordinates are relative to the layout dimensions. Coordinates can extend beyond the [0, 1] range; such values indicate that the shape will be cropped.

Points: The bounding box must always have exactly 4 points. Each point is an array of two floats [x, y] representing the relative position.

Supported Characters: The text field must contain an individual word composed of the following supported characters:

! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : < > ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z _ { } Ø Đ Ħ Ł Ŋ Ŧ Α Β Ε Ζ Η Ι Κ Μ Ν Ο Ρ Τ Υ Χ І А В Е К М Н О Р С Т У Х ß ẞ

Any character not listed above will result in validation errors.

Example:

"text_layout": [
    {
        "text": "Recraft",
        "bbox": [[0.3, 0.45], [0.6, 0.45], [0.6, 0.55], [0.3, 0.55]]
    },
    {
        "text": "AI",
        "bbox": [[0.62, 0.45], [0.70, 0.45], [0.70, 0.55], [0.62, 0.55]]
    }
]

Appendix

List of styles

Style	Recraft V3 Substyles	Recraft V2 Substyles
`any`	(not applicable)	(not available)
`realistic_image`	- b_and_w - enterprise - evening_light - faded_nostalgia - forest_life - hard_flash - hdr - motion_blur - mystic_naturalism - natural_light - natural_tones - organic_calm - real_life_glow - retro_realism - retro_snapshot - studio_portrait - urban_drama - village_realism - warm_folk	- b_and_w - enterprise - hard_flash - hdr - motion_blur - natural_light - studio_portrait
`digital_illustration`	- 2d_art_poster - 2d_art_poster_2 - antiquarian - bold_fantasy - child_book - cover - crosshatch - digital_engraving - engraving_color - expressionism - freehand_details - grain - grain_20 - graphic_intensity - hand_drawn - hand_drawn_outline - handmade_3d - hard_comics - infantile_sketch - long_shadow - modern_folk - multicolor - neon_calm - noir - nostalgic_pastel - outline_details - pastel_gradient - pastel_sketch - pixel_art - plastic - pop_art - pop_renaissance - seamless - street_art - tablet_sketch - urban_glow - urban_sketching - young_adult_book - young_adult_book_2	- 2d_art_poster - 2d_art_poster_2 - 3d - 80s - engraving_color - glow - grain - hand_drawn - hand_drawn_outline - handmade_3d - infantile_sketch - kawaii - pixel_art - plastic - psychedelic - seamless - voxel - watercolor
`vector_illustration`	- bold_stroke - chemistry - colored_stencil - cosmics - cutout - depressive - editorial - emotional_flat - engraving - line_art - line_circuit - linocut - marker_outline - mosaic - naivector - roundish_flat - seamless - segmented_colors - sharp_contrast - thin - vector_photo - vivid_shapes	- cartoon - doodle_line_art - engraving - flat_2 - kawaii - line_art - line_circuit - linocut - seamless
`icon`	(not available)	- broken_line - colored_outline - colored_shapes - colored_shapes_gradient - doodle_fill - doodle_offset_fill - offset_fill - outline - outline_gradient - pictogram
`logo_raster`	- emblem_graffiti - emblem_pop_art - emblem_punk - emblem_stamp - emblem_vintage	(not available)

List of image sizes

1024x1024

1365x1024

1024x1365

1536x1024

1024x1536

1820x1024

1024x1820

1024x2048

2048x1024

1434x1024

1024x1434

1024x1280

1280x1024

1024x1707

1707x1024

Policies

All generated images are currently stored for approx. 24 hours. This policy may change in the future, and you should not rely on it remaining constant.

Recraft Image

Recraft Image Generation and Editing API#

Features#

Styles#

Realistic#

Digital illustration#

Vector illustration#

Icon#

Auxiliary#

Controls#

Colors#

Text Layout#

Appendix#

List of styles#

List of image sizes#

Policies#