Recraft

Design Agent

Talk to Recraft's Design Agent in a chat. This is not just any agent — it is The Design Agent, and its superpower is turning a brief — a plain description of a digital product — into a strong, consistent and genuinely amazing set of design assets. Building a coherent look normally means juggling separate tools — one for the logo, another for icons, another for social assets — and without a designer to hold it together the result feels like five apps that have never met. The Design Agent does it all at once: describe the product and it produces a full, consistent set of design assets — a logo, a colour palette, typography, an app icon and social assets among them — and can save them as a reusable Design Kit so every asset pulled from it later stays consistent. It is built for digital products: apps, websites and similar projects. Reach for it whenever the user needs a whole coherent look rather than a single one-off image. This is a two-way, turn-based conversation, not a one-shot request: you send a text message (optionally with input images) and receive the agent's combined reply, which may include images the agent generates. The agent often drives the exchange itself — instead of a final result it may reply with a clarifying question or a set of choices (for example confirming it should proceed, asking for visual references or a preferred direction, or asking which option to develop). When it does, relay that reply to the end user verbatim, collect their answer, and send it back in a follow-up call — do not answer on the user's behalf or skip ahead. A single task can take several turns before the agent produces its final design assets. Omit chat_id to start a new conversation; the response contains the chat_id — pass it in every subsequent call to continue the same conversation with full context. Images flow both ways. To send images to the agent, provide input_image_urls, a list of publicly accessible HTTPS URLs (PNG, JPEG or WEBP); if you only have local image files, call request_upload_url first, PUT the image bytes to the returned upload URL, and pass the resulting image_url values here. Any images the agent generates come back in the response. The response contains the agent's text answer, the chat_id, URLs of any generated images with WEBP previews as base64 encoded bytes, and consumed credits.

Requiredmessage

Create style

Create a custom style from one or more reference images. Provide images via URLs or base64-encoded data. The style parameter defines the base style type.

Requiredinput_image_type

Creative upscale

Upscale an image using creative AI enhancement. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_url

Crisp upscale

Upscale an image with sharp, crisp quality enhancement. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_url

Delete style

Delete a custom style by its ID.

Requiredinput_style_id

Erase region

Erase a masked region from an image, filling it with content-aware background. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlmask_image_url

Generate background

Generate a background for a masked region of an image based on a text prompt. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlmask_image_urlprompt

Generate image

Generate an image from a text prompt. You can specify the image size, style, model, and number of images to generate. You don't need to change default parameters if you don't have any specific requirements. Recraft has both raster and vector models. Every base model comes in a `_raster` and a `_vector` variant: a raster model (e.g. recraftv4_1_raster) produces a raster image (PNG/WEBP), while a vector model (e.g. recraftv4_1_vector) produces a true SVG vector file. Whenever the user asks for a vector, an SVG, a scalable logo, or an icon, pass the `_vector` variant of the model — that is the reliable way to get an SVG. Use the `_raster` variant (or the plain model name) for photos and raster artwork. See the `model` parameter for the full list of variants. Recraft also has a large library of built-in "basic styles" beyond the default models. Call the `list_basic_styles` tool to explore the full variety of available styles, then apply a chosen one via its `input_style_id`. URLs to generated images and their previews in WEBP format as base64 encoded bytes will be returned in the response.

Requiredprompt

Get style

Get details of a specific style by its ID.

Requiredstyle_id

Get user information

Get information about the current user (ID, email, name, and credit balance).

Image edit

Edit one or more input images according to a text prompt, producing new image(s). Use this tool for instruction-driven editing: describe the change you want (for example "add a hat", "make it winter", "replace the text with SALE", or "combine these images") and the model rewrites the image to follow the prompt. It can take several input images at once and can use external models. Choose image_edit when you want the model to follow explicit editing instructions or to use an external model; choose image_to_image instead when you want a strength-controlled stylistic transformation of a single image rather than a specific edit. Provide the source images as `input_image_urls` — a list of publicly accessible HTTPS URLs (PNG, JPEG or WEBP). If you only have local image files with no public URL, call `request_upload_url` for each, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` values here. You can specify the image size, style, model, and number of images to generate. You don't need to change default parameters if you don't have any specific requirements. In addition to Recraft models this tool supports external models (for example nano_banana_pro, gemini_25_flash_image, flux1_kontext_pro, bytedance-seedreamv4, qwen_image); availability depends on your subscription and is validated server-side. If the image size is not specified, the output size follows the first input image. URLs to the edited images and their previews in WEBP format as base64 encoded bytes will be returned in the response.

Requiredpromptinput_image_urls

Image to image

Transform an existing image based on a text prompt. The strength parameter controls how much the image is transformed (0.0 to 1.0). Provide a publicly accessible HTTPS URL as `input_image_url`. Use this tool for a strength-controlled stylistic transformation of a single image, where the prompt and style reshape the whole image and `strength` sets how far the result moves from the original. For instruction-driven edits (changing or adding specific elements, editing several images together, or using an external model such as nano_banana_pro or flux1_kontext_pro), use the image_edit tool instead. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlpromptstrength

Inpaint image

Fill in a masked region of an image based on a text prompt. Provide the source image as `input_image_url` and a mask image as `mask_image_url`, both publicly accessible HTTPS URLs. If you only have local image files with no public URLs, call `request_upload_url` for each, PUT the image bytes to each returned upload URL, and pass the resulting `image_url` values here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlmask_image_urlprompt

List styles

List all custom styles created by the current user. Returns a list of style IDs, their types, and creation info.

Remove background

Remove the background from an image. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image with background removed as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_url

Replace background

Replace the background of an image based on a text prompt. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlprompt

Request upload URL

Issue an upload URL for a direct image upload. Use this when the user provides a local image file (or raw image data) that has no public URL of its own. If the user already provided a public HTTPS image URL, pass that URL directly to the image tools instead — do NOT route it through this step. This tool takes no parameters and returns an `upload_url` plus a ready-to-run `curl` command. PUT the raw image bytes directly to `upload_url` (no base64, no encoding) with a `Content-Type` header matching the image MIME type (image/png, image/jpeg or image/webp), e.g.: curl -X PUT -H 'Content-Type: image/png' --data-binary @image.png '<upload_url>' The PUT response is JSON containing `image_url`. Use that `image_url` as `input_image_url` (or `mask_image_url`) when calling any image tool such as image_to_image, remove_background, inpaint_image, etc. The link is valid for 15 minutes and may be reused.

Subscription plans

List available Recraft subscription plans with their credits, refill periods, and pricing identifiers.

Suggest model

Suggest the best Recraft image generation model for a given user request. Picks between recraftv4_1_pro, recraftv4_1, recraftv3, and recraftv2 based on the description.

Requiredsuggest_model_request

Variate image

Generate variations of an existing image. Use the size parameter to set the output dimensions. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_urlimage_size

Vectorize image

Convert a raster image to a vector format. Provide a publicly accessible HTTPS URL as `input_image_url`. If you only have a local image file with no public URL, call `request_upload_url` first, PUT the image bytes to the returned upload URL, and pass the resulting `image_url` here. Returns the processed image as a URL and a preview in WEBP format as a base64 encoded bytes.

Requiredinput_image_url