Welcome to 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

Digital illustration

Vector illustration

Icon

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.
‍

Model

Recraft developed two powerful models: Recraft V2 (also known as Recraft 20B) and Recraft V3. The Recraft V2 model was released in February 2024 and was the first AI model built specifically for designers. It allowed them to create both vector and raster images that are anatomically perfect, maintain consistent brand style and also iterate with ultimate control and precision. In October 2024 the new model was introduced - Recraft V3. Our team trained a new SOTA model from scratch and set a new standard for excellence in image generation. Recraft V3 participated in the Hugging Face’s industry-leading Text-to-Image Model Leaderboard by Artificial Analysis. It secured #1 place with ELO rating of 1172. Now both models are available through the Recraft API.

Pricing

API Unit package pricing

The following are the API Unit packages available from Recraft for the use of the Recraft API Service. API Unit packages must be purchased in advance and all API Unit packages are non-cancellable and non-refundable. Any number of unit packages can be bought.

Price	API units
UD $1.00	1,000

API Unit charges for API services

The following are the Service charges (in API Units) for use of the API Services. API Units will be automatically deducted from Member’s pre-purchased API Unit package upon use of the described Service by the Member.

Service description	Cost (USD)	API units charged
Raster image generation – Recraft V3	$0.04	40
Raster image generation – Recraft V2	$0.022	22
Vector image generation – Recraft V3	$0.08	80
Vector image generation – Recraft V2	$0.044	44
Raster image to image (per single image)	$0.04	40
Vector image to image (per single image)	$0.08	80
Raster image inpainting (per single image)	$0.04	40
Vector image inpainting (per single image)	$0.08	80
Replace raster background (per single image)	$0.04	40
Replace vector background (per single image)	$0.08	80
Image style creation	$0.04	40
Image vectorization	$0.01	10
Image background removal	$0.01	10
Crisp upscale	$0.004	4
Creative upscale	$0.25	250
Erase region	$0.002	2

Getting started

Authenticate and interact with our API in a matter of minutes.

Authentication

We use Bearer API tokens for authentication. To access your API key, log in to Recraft, enter your profile and hit ‘Generate’ (available only if your API units balance is above zero). All requests should include your API key in an Authorization HTTP header as follows:
‍
‍Authorization: Bearer RECRAFT_API_TOKEN

REST / Python Library

The Recraft API adheres to REST principles, allowing you to interact using any utilities (e.g., curl), programming languages, or libraries of your choice. One of the easiest of available alternatives is OpenAI Python library which is also compatible with Recraft API, but it’s important to remember that not all parameters/options are supported or implemented. Additionally, some parameters may have different meanings, or they may be quietly ignored if they are not applicable to the Recraft API. Future examples will be shown using that library, for example, once installed, you can use the following code to be authenticated:

from openai import OpenAI

client = OpenAI(
    base_url='https://external.api.recraft.ai/v1',
    api_key=<TOKEN>,
)

Usage

Dig into the details of using the Recraft API.

Generate image

Creates an image given a prompt.

POST https://external.api.recraft.ai/v1/images/generations

Example

response = client.images.generate(
    prompt='race car on a track',
    style='digital_illustration',
)
print(response.data[0].url)

Output

https://img.recraft.ai/-dSeKnnWTUbG9wnzpV6OjN7I7PlFxAFmg6nyhvd3qSE/rs:fit:1024:1024:0/raw:1/plain/abs://external/images/cbb1770e-3e7e-49fd-bf17-7c689f6906c1

Parameter	Type	Description
prompt (required)	string	A text description of the desired image(s). The maximum length is 1000 bytes.
text_layout	Array of objects or null	Available in `recraftv3` model only. This topic is covered below.
n	integer or null, default is 1	The number of images to generate, must be between 1 and 6.
style_id	UUID or null	Use a previously uploaded style as a reference, this topic is covered above and below.
style	string or null, default is `realistic_image`	The style of the generated images, this topic is covered above.
substyle	string or null	This topic is covered above.
model	string or null, default is `recraftv3`	The model to use for image generation. Must be one of `recraftv3` or `recraftv2`.
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.
size	string or null, default is `1024x1024`	The size of the generated images in `WxH` format, supported values are published below.
negative_prompt	string or null	A text description of undesired elements on an image.
controls	object or null	A set of custom parameters to tweak generation process, this topic is covered below.

Note: style_id and style parameters are mutually exclusive. If neither of the two parameters is specified, the default style of realistic_image will be used ‍Hint: if OpenAI Python Library is used, non-standard parameters can be passed using the extra_body argument. For example:

response = client.images.generate(
    prompt='race car on a track',
    extra_body={
        'style_id': style_id,
        'controls': {
            ...
        }
    }
)
print(response.data[0].url)

Image to image

Image-to-image operation transforms an input image into an output image, preserving certain aspects while altering others based on the prompt.

POST https://external.api.recraft.ai/v1/images/imageToImage

Example

response = client.post(
    path='/images/imageToImage',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={
        'image': open('image.png', 'rb'),
    },
    body={
        'prompt': 'winter',
        'strength': 0.2,
    },
)
print(response['data'][0]['url'])

Output

https://img.recraft.ai/f1LAVICjQjTDUbVlwlA4AbE_JBjEQU2t6ho6YhI0J8M/rs:fit:1024:1024:0/raw:1/plain/abs://external/images/6d85db5d-912f-4711-957c-15cbebc8cb24

Parameters

Parameter	Type	Description
image (required)	file	An image to modify, must be less than 5 MB in size, have resolution less than 16 MP, and max dimension less than 4096 pixels.
prompt (required)	string	A text description of areas to change. The maximum length is 1000 bytes.
strength (required)	float	Defines the difference with the original image, should lie in `[0, 1]`, where `0` means almost identical, and `1` means minimal similarity.
n	integer or null, default is 1	The number of images to generate, must be between 1 and 6.
style_id	UUID or null	Use a previously uploaded style as a reference, this topic is covered above and below.
style	string or null, default is `realistic_image`	The style of the generated images, this topic is covered above.
substyle	string or null	This topic is covered above.
model	string or null, default is `recraftv3`	The model to use for image generation. Only `recraftv3` is supported at the moment.
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.
negative_prompt	string or null	A text description of undesired elements on an image.
controls	object or null	A set of custom parameters to tweak generation process, this topic is covered below.

Note: style_id and style parameters are mutually exclusive. If neither of the two parameters is specified, the default style of “any" will be used

Image inpainting

Inpainting replaces or modifies specific parts of an image. It uses a mask to identify the areas to be filled in, where white pixels represent the regions to inpaint, and black pixels indicate the areas to keep intact, i.e. the white pixels are filled based on the input provided in the prompt.

POST https://external.api.recraft.ai/v1/images/inpaint

Example

response = client.post(
    path='/images/inpaint',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={
        'image': open('image.png', 'rb'),
        'mask': open('mask.png', 'rb'),
    },
    body={
        'prompt': 'winter',
    },
)
print(response['data'][0]['url'])

Output

https://img.recraft.ai/HMd15RTSXeRfEluSPq828pZ7DW9NaI4oR2adSVk_wXc/rs:fit:1024:1024:0/raw:1/plain/abs://external/images/a97b9cc2-4498-41d8-9904-1d58e04b239b

Parameters

Body of a request should contains an image file and a mask in PNG, JPG or WEBP format and parameters passed as content type 'multipart/form-data'. The image must be no more than 5 MB in size, have resolution no more than 16 MP, max dimension no more than 4096 pixels and min dimension no less than 256 pixels.

Parameter	Type	Description
image (required)	file	An image to modify, must be less than 5 MB in size, have resolution less than 16 MP, and max dimension less than 4096 pixels.
mask (required)	file	An image encoded in grayscale color mode, used to define the specific regions of an image that need modification. The white pixels represent the parts of the image that will be inpainted, while black pixels indicate the parts of the image that will remain unchanged. Should have exactly the same size as the image. Each pixel of the image should be either pure black (value `0`) or pure white (value `255`).
prompt (required)	string	A text description of areas to change. The maximum length is 1000 bytes.
n	integer or null, default is 1	The number of images to generate, must be between 1 and 6.
style_id	UUID or null	Use a previously uploaded style as a reference, this topic is covered above and below.
style	string or null, default is `realistic_image`	The style of the generated images, this topic is covered above.
substyle	string or null	This topic is covered above.
model	string or null, default is `recraftv3`	The model to use for image generation. Only `recraftv3` is supported at the moment.
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.
negative_prompt	string or null	A text description of undesired elements on an image.

Note: style_id and style parameters are mutually exclusive. If neither of the two parameters is specified, the default style of “any" will be used

Replace background

Replace Background operation detects background of an image and modifies it according to given prompt.

POST https://external.api.recraft.ai/v1/images/replaceBackground

Example

response = client.post(
    path='/images/replaceBackground',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={
        'image': open('image.png', 'rb'),
    },
    body={
        'prompt': 'winter',
    },
)
print(response['data'][0]['url'])

Output

https://img.recraft.ai/59eRxsKN87Tr-LLFleTm01RZSsSTuoZcHTzT9b1r_XM/rs:fit:1024:1024:0/raw:1/plain/abs://external/images/234453e8-6abf-472f-9ac7-9b8c7eca2f80

Parameters

Body of a request should contains an image file in PNG, JPG or WEBP format and parameters passed as content type 'multipart/form-data'. The image must be no more than 5 MB in size, have resolution no more than 16 MP, max dimension no more than 4096 pixels and min dimension no less than 256 pixels.

Parameter	Type	Description
image (required)	file	An image to modify, must be less than 5 MB in size, have resolution less than 16 MP, and max dimension less than 4096 pixels.
prompt (required)	string	A text description of areas to change. The maximum length is 1000 bytes.
n	integer or null, default is 1	The number of images to generate, must be between 1 and 6.
style_id	UUID or null	Use a previously uploaded style as a reference, this topic is covered above and below.
style	string or null, default is `realistic_image`	The style of the generated images, this topic is covered above.
substyle	string or null	This topic is covered above.
model	string or null, default is `recraftv3`	The model to use for image generation. Only `recraftv3` is supported at the moment.
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.
negative_prompt	string or null	A text description of undesired elements on an image.

Note: style_id and style parameters are mutually exclusive. If neither of the two parameters is specified, the default style of “any" will be used

Vectorize image

Converts a given raster image to SVG format.

POST https://external.api.recraft.ai/v1/images/vectorize

Example

response = client.post(
    path='/images/vectorize',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={'file': open('image.png', 'rb')},
)
print(response['image']['url'])

Output

https://img.recraft.ai/fZm6nwEjI9Qy94LukIKbxRm4w2i5crwqu459qKg7ZWY/rs:fit:1341:1341:0/raw:1/plain/abs://external/images/2835e19f-282b-419b-b80c-9231a3d51517

Parameters

Body of a request should be a file in PNG, JPG or WEBP format and parameters passed as content type 'multipart/form-data'. The image must be no more than 5 MB in size, have resolution no more than 16 MP, max dimension no more than 4096 pixels and min dimension no less than 256 pixels.

Parameter	Type	Description
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.

Remove background

Removes background of a given raster image.

POST https://external.api.recraft.ai/v1/images/removeBackground

Example

response = client.post(
    path='/images/removeBackground',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={'file': open('image.png', 'rb')},
)
print(response['image']['url'])

Output

https://img.recraft.ai/EYOLjpky-2-uClelfP61kzK-SEpIhKgLfjLFFGxmM_U/rs:fit:0:0:0/raw:1/plain/abs://external/images/e2d0cba6-12df-4141-aa21-43bfd5889990

Parameters

Parameter	Type	Description
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.

Crisp upscale

Enhances a given raster image using ‘crisp upscale’ tool, increasing image resolution, making the image sharper and cleaner.

POST https://external.api.recraft.ai/v1/images/crispUpscale

Example

response = client.post(
    path='/images/crispUpscale',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={'file': open('image.png', 'rb')},
)
print(response['image']['url'])

Output

https://img.recraft.ai/LtCo_bs3chC8zhrku0CWLpCBKv4iOODprEdeD_MY1dw/rs:fit:1760:2348:0/raw:1/plain/abs://external/images/f7d01b15-0eba-4439-a5fb-38af38fb524e

Request body

Body of a request should be a file in PNG, JPG or WEBP format and parameters passed as content type multipart/form-data. The image must be no more than 5 MB in size, have resolution no more than 4 MP, max dimension no more than 4096 pixels and min dimension no less than 32 pixels.

Parameter	Type	Description
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.

Creative upscale

Enhances a given raster image using ‘creative upscale’ tool, boosting resolution with a focus on refining small details and faces.

POST https://external.api.recraft.ai/v1/images/creativeUpscale

Example

response = client.post(
    path='/images/creativeUpscale',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={'file': open('image.png', 'rb')},
)
print(response['image']['url'])

Output

https://img.recraft.ai/DV4d9pMeq5lIluqS7m8qHyg-mb6hf5uCqEPPC8t8wy4/rs:fit:4740:3536:0/raw:1/plain/abs://external/images/fb576169-8a66-4270-a566-35713ad72020

Request body

Body of a request should be a file in PNG, JPG or WEBP format and parameters passed as content type multipart/form-data. The image must be no more than 5 MB in size, have resolution no more than 16 MP, max dimension no more than 4096 pixels and min dimension no less than 256 pixels.

Parameter	Type	Description
response_format	string or null, default is `url`	The format in which the generated images are returned. Must be one of `url` or `b64_json`.

Create style

Upload a set of images to create a style reference.

POST https://external.api.recraft.ai/v1/styles

Example

response = client.post(
    path='/styles',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    body={'style': 'digital_illustration'},
    files={'file1': open('image.png', 'rb')},
)
print(response['id'])

Output

{"id": "229b2a75-05e4-4580-85f9-b47ee521a00d"}

Request body

Upload a set of images to create a style reference.

Parameter	Type	Description
style (required)	string	The base style of the generated images, this topic is covered above.
files (required)	files	Images in PNG, JPG, or WEBP format for use as style references. The max number of images is 5. Total size of all images is limited to 5 MB.

Get user information

Returns information of the current user including credits balance.

GET https://external.api.recraft.ai/v1/users/me

Example

response = client.get(path='/users/me', cast_to=object)
print(response)

Output

{
    "credits": 1000,
    "email": "test@example.com",
    "id": "c18a1988-45e7-4c00-82c4-4ad7d3dbce3a",
    "name": "Recraft Test"
}

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

Color type is defined as an object with the following fields | rgb (required) | An array of 3 integer values in range of 0...255 defining RGB color model. | Example

response = client.images.generate(
    prompt='race car on a track',
    style='realistic_image',
    extra_body={
        'controls': {
            'colors': [
                {'rgb': [0, 255, 0]}
            ]
        }
    }
)
print(response.data[0].url)

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). | 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, (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 a single word composed only of the following 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

response = client.images.generate(
    prompt="cute red panda with a sign",
    style="digital_illustration",
    extra_body={
        "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]],
            },
        ]
    },
)
print(response.data[0].url)

Guides

Generate AI images using cURL or Python and create your own styles programmatically.

Generate a digital illustration using RecraftV3 model

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "two race cars on a track",
        "style": "digital_illustration",
        "model": "recraftv3"
    }'

Generate a digital illustration with specific substyle

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "a monster with lots of hands",
        "style": "digital_illustration",
        "substyle": "hand_drawn"
    }'

Image to image with digital illustration style

curl -X POST https://external.api.recraft.ai/v1/images/imageToImage \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "image=@image.png" \
    -F "prompt=winter" \
    -F "strength=0.2" \
    -F "style=digital_illustration"

Inpaint an image with digital illustration style

curl -X POST https://external.api.recraft.ai/v1/images/inpaint \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "prompt=moon" \
    -F "style=digital_illustration" \
    -F "image=@image.png" -F "mask=@mask.png"

from openai import OpenAI

client = OpenAI(base_url='https://external.api.recraft.ai/v1', api_key=_RECRAFT_API_TOKEN)

response = client.post(
    path='/images/inpaint',
    cast_to=object,
    options={'headers': {'Content-Type': 'multipart/form-data'}},
    files={
        'image': open('image.png', 'rb'),
        'mask': open('mask.png', 'rb'),
    },
    body={
        'style': 'digital_illustration',
        'prompt': 'moon',
    },
)
print(response['data'][0]['url'])

Create own style by uploading reference images and use them for generation

curl -X POST https://external.api.recraft.ai/v1/styles \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "style=digital_illustration" \
    -F "file=@image.png"

# response: {"id":"095b9f9d-f06f-4b4e-9bb2-d4f823203427"}

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "wood potato masher",
        "style_id": "095b9f9d-f06f-4b4e-9bb2-d4f823203427"
    }'

Vectorize an image in PNG format

curl -X POST https://external.api.recraft.ai/v1/images/vectorize \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "file=@image.png"

Remove background from a PNG image, get the result in B64 JSON

curl -X POST https://external.api.recraft.ai/v1/images/removeBackground \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "response_format=b64_json" \
    -F "file=@image.png"

Run crisp upscale tool for a PNG image, get the result in B64 JSON

curl -X POST https://external.api.recraft.ai/v1/images/crispUpscale \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "response_format=b64_json" \
    -F "file=@image.png"

Run creative upscale tool for a PNG image

curl -X POST https://external.api.recraft.ai/v1/images/creativeUpscale \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "file=@image.png"

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.
Images are publicly accessible via direct links without authentication. However, since the URLs include unique image identifiers and are cryptographically signed, restoring lost links is nearly impossible.
Currently, image generation rates are defined on a per-user basis and set at 100 images per minute. These rates may be adjusted in the future.

Need help or have suggestions for improving our docs? Contact support

API

​Features

​Styles

​Model

​Pricing

​API Unit package pricing

​API Unit charges for API services

​Getting started

​Authentication

​REST / Python Library

​Usage

​Generate image

​Example

​Output

​Image to image

​Example

​Output

​Parameters

​Image inpainting

​Example

​Output

​Parameters

​Replace background

​Example

​Output

​Parameters

​Vectorize image

​Example

​Output

​Parameters

​Remove background

​Example

​Output

​Parameters

​Crisp upscale

​Example

​Output

​Request body

​Creative upscale

​Example

​Output

​Request body

​Create style

​Example

​Output

​Request body

​Get user information

​Example

​Output

​Auxiliary

​Controls

​Colors

​Text Layout

​Guides

​Generate a digital illustration using RecraftV3 model

​Generate a digital illustration with specific substyle

​Image to image with digital illustration style

​Inpaint an image with digital illustration style

​Create own style by uploading reference images and use them for generation

​Vectorize an image in PNG format

​Remove background from a PNG image, get the result in B64 JSON

​Run crisp upscale tool for a PNG image, get the result in B64 JSON

​Run creative upscale tool for a PNG image

​Appendix

​List of styles

​List of image sizes

​Policies

Features

Styles

Model

Pricing

API Unit package pricing

API Unit charges for API services

Getting started

Authentication

REST / Python Library

Usage

Generate image

Example

Output

Image to image

Example

Output

Parameters

Image inpainting

Example

Output

Parameters

Replace background

Example

Output

Parameters

Vectorize image

Example

Output

Parameters

Remove background

Example

Output

Parameters

Crisp upscale

Example

Output

Request body

Creative upscale

Example

Output

Request body

Create style

Example

Output

Request body

Get user information

Example

Output

Auxiliary

Controls

Colors

Text Layout

Guides

Generate a digital illustration using RecraftV3 model

Generate a digital illustration with specific substyle

Image to image with digital illustration style

Inpaint an image with digital illustration style

Create own style by uploading reference images and use them for generation

Vectorize an image in PNG format

Remove background from a PNG image, get the result in B64 JSON

Run crisp upscale tool for a PNG image, get the result in B64 JSON

Run creative upscale tool for a PNG image

Appendix

List of styles

List of image sizes

Policies