---
canonical_url: "https://docs.composio.dev/toolkits/recraft"
markdown_url: "https://docs.composio.dev/toolkits/recraft.md"
product: "platform"
version: null
last_updated: null
---

# Recraft

Generate, transform, upscale, vectorize, and manage image styles with Recraft's native API.

- **Category:** ai content generation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 22
- **Triggers:** 0
- **Slug:** `RECRAFT`
- **Version:** 00000000_00

## Tools

### Create Custom Style

**Slug:** `RECRAFT_CREATE_STYLE`

Create a private reusable style in the connected Recraft account from one to ten bounded reference images, existing V2/V3 styles, or both. The paid request is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `match` | string ("regular" | "precise" | "flexible") | No | Optional style matching mode: regular for V2/V3, or flexible/precise for V4/V4.1. |
| `model` | string ("recraftv2" | "recraftv2_raster" | "recraftv2_vector" | "recraftv3" | "recraftv3_raster" | "recraftv3_vector" | "recraftv4" | "recraftv4_raster" | "recraftv4_vector" | "recraftv4_pro" | "recraftv4_pro_raster" | "recraftv4_pro_vector" | "recraftv4_1" | "recraftv4_1_raster" | "recraftv4_1_vector" | "recraftv4_1_pro" | "recraftv4_1_pro_raster" | "recraftv4_1_pro_vector" | "recraftv4_1_utility" | "recraftv4_1_utility_raster" | "recraftv4_1_utility_vector" | "recraftv4_1_utility_pro" | "recraftv4_1_utility_pro_raster" | "recraftv4_1_utility_pro_vector" | "recraftv4_styles" | "recraftv4_styles_raster" | "recraftv4_styles_vector" | "recraftv4_styles_pro" | "recraftv4_styles_pro_raster" | "recraftv4_styles_pro_vector") | No | Optional canonical Recraft model for the style. Omit it to use recraftv4_styles. Flash and external models are not accepted. |
| `style` | string ("any" | "digital_illustration" | "icon" | "realistic_image" | "vector_illustration" | "logo_raster") | No | Optional base image style compatible with the model. |
| `images` | array | No | One to ten PNG, JPEG, or WebP references as protected Composio file uploads, public HTTP(S) URLs, or Base64 image data URLs. Local content must be under 20 MB per image and at most 64 MB in total. |
| `prompt` | string | No | Optional prompt associated with the style; V2/V3 allow up to 1,000 characters and V4/V4.1 up to 10,000. |
| `palette` | object | No | Optional color palette stored with the style. |
| `mix_policy` | string ("PaletteMatch" | "MaxWeight") | No | Optional V2/V3 policy for mixing image and existing-style sources. |
| `image_weights` | array | No | Optional per-image weights, one for every reference image. |
| `source_styles` | array | No | Optional existing V2/V3 style UUIDs to mix into the new style. |
| `source_style_weights` | array | No | Optional per-source-style weights, one for every source style. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Creative Upscale Image

**Slug:** `RECRAFT_CREATIVE_UPSCALE_IMAGE`

Increase one raster image's resolution while regenerating fine details and faces. Returns one temporary public signed URL. This paid operation is sent once without automatic HTTP retries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zdr` | boolean | No | Request zero data retention. |
| `image` | string | Yes | Source PNG, JPEG, or WebP as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `image_format` | string ("webp" | "png") | No | Output WebP or PNG; omit for lossless WebP. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Crisp Upscale Image

**Slug:** `RECRAFT_CRISP_UPSCALE_IMAGE`

Increase one raster image's resolution while sharpening it without promising a specific scale factor, then return a public signed URL that normally expires in about 24 hours. This duration is not guaranteed; download durable results promptly. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image` | string | Yes | Source PNG, JPEG, or WebP as a protected Composio file upload, public HTTP(S) URL, or Base64 image data URL. Local content must be under 20 MB, 32-4096 px per side, and no more than 16 megapixels. |
| `image_format` | string ("webp" | "png") | No | Output format. Omit for Recraft's lossless WebP default, or choose PNG. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Custom Style

**Slug:** `RECRAFT_DELETE_STYLE`

Permanently delete one style by UUID from the connected Recraft account. The destructive request is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `style_id` | string | Yes | UUID of a style in the connected Recraft account to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enhance Image Details

**Slug:** `RECRAFT_ENHANCE_IMAGE`

Re-render one raster image with Recraft V4.1 Pro for sharper texture and detail while retaining its composition. Returns one temporary public URL; the paid operation is sent once without automatic HTTP retries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zdr` | boolean | No | Request zero data retention. |
| `image` | string | Yes | Source PNG, JPEG, or WebP as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `refinement` | string ("subtle" | "moderate") | No | How much detail may change; moderate is the provider default. |
| `image_format` | string ("webp" | "png") | No | Output WebP or PNG; omit for lossless WebP. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Enhance Prompt

**Slug:** `RECRAFT_ENHANCE_PROMPT`

Expand a text prompt with visual context, style cues, and composition details. This text-only operation returns an enhanced prompt, not an image. It is a paid 10-unit request sent once without automatic HTTP retries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompt` | string | Yes | Text prompt to enrich (1-2,000 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Erase Image Region

**Slug:** `RECRAFT_ERASE_IMAGE_REGION`

Erase the pure-white area of a black-and-white mask from one raster or opaque untrusted SVG image. Returns one temporary public URL; the paid operation is sent once without automatic HTTP retries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `zdr` | boolean | No | Request zero data retention. |
| `mask` | string | Yes | Grayscale PNG, JPEG, or WebP mask as a protected upload, public HTTP(S) URL, or Base64 data URL. Local masks must match a local raster source's dimensions and contain only pure black and white pixels. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `image_format` | string ("webp" | "png") | No | Raster output WebP or PNG; ignored when the source is SVG. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Image

**Slug:** `RECRAFT_GENERATE_IMAGE`

Generate one to six raster or vector images with any documented Recraft model, returning public signed URLs that normally expire in about 24 hours. This duration is not guaranteed; download durable results promptly and treat vector SVG output as untrusted. Use this model-selectable endpoint when output type is chosen dynamically; use Generate Raster Image or Generate Vector Image when the provider must enforce one output type. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to generate, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `size` | string ("1024x1024" | "1365x1024" | "1024x1365" | "1536x1024" | "1024x1536" | "1820x1024" | "1024x1820" | "1024x2048" | "2048x1024" | "1434x1024" | "1024x1434" | "1024x1280" | "1280x1024" | "1024x1707" | "1707x1024" | "1216x896" | "896x1216" | "1280x832" | "832x1280" | "1152x896" | "896x1152" | "1280x896" | "896x1280" | "832x1344" | "768x1344" | "1344x768" | "768x1536" | "1536x768" | "2048x2048" | "2432x1792" | "1792x2432" | "2560x1664" | "1664x2560" | "2304x1792" | "1792x2304" | "2560x1792" | "1792x2560" | "1664x2688" | "1536x2688" | "2688x1536" | "1536x3072" | "3072x1536" | "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") | No | Output aspect ratio w:h, supported by every model, or a documented exact WxH size compatible with the selected raster model. Vector models accept ratios only. |
| `model` | string ("recraftv2" | "recraftv2_raster" | "recraftv2_vector" | "recraftv3" | "recraftv3_raster" | "recraftv3_vector" | "recraftv4" | "recraftv4_raster" | "recraftv4_vector" | "recraftv4_pro" | "recraftv4_pro_raster" | "recraftv4_pro_vector" | "recraftv4_1" | "recraftv4_1_raster" | "recraftv4_1_vector" | "recraftv4_1_pro" | "recraftv4_1_pro_raster" | "recraftv4_1_pro_vector" | "recraftv4_1_utility" | "recraftv4_1_utility_raster" | "recraftv4_1_utility_vector" | "recraftv4_1_utility_pro" | "recraftv4_1_utility_pro_raster" | "recraftv4_1_utility_pro_vector" | "recraftv4_styles" | "recraftv4_styles_raster" | "recraftv4_styles_vector" | "recraftv4_styles_pro" | "recraftv4_styles_pro_raster" | "recraftv4_styles_pro_vector" | "recraftv4_1_flash" | "recraftv4_1_flash_raster") | No | Optional Recraft generation model. Omit it for recraftv4_1, or recraftv4_styles when style_reference_urls are supplied. External models are not accepted. |
| `style` | string | No | Optional model-compatible curated style name. |
| `prompt` | string | Yes | Text description of the desired images; V2/V3 allow up to 1,000 characters and newer models up to 10,000. |
| `upscale` | string ("upscale4mp" | "upscale16mp") | No | Optional provider generation upscale mode. |
| `controls` | object | No | Optional generation controls. |
| `style_id` | string | No | Optional compatible custom style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string ("regular" | "precise" | "flexible") | No | Style matching mode: regular for V2/V3, or flexible/precise for V4/V4.1. |
| `text_layout` | array | No | V3-only words and four-point placement polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; vector output is always SVG. |
| `negative_prompt` | string | No | V2/V3-only description of undesired content. |
| `style_reference_urls` | array | No | One to ten PNG, JPEG, or WebP style references as protected Composio uploads, public HTTP(S) URLs, or Base64 image data URLs. Local content must be under 20 MB per image and at most 64 MB in total. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Image Background

**Slug:** `RECRAFT_GENERATE_IMAGE_BACKGROUND`

Generate a new background in the pure-white area of a mask while preserving black areas. Produces one to six V3 raster or untrusted V3 SVG results in one paid, non-retried request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to create, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `mask` | string | Yes | Grayscale PNG, JPEG, or WebP mask as a protected upload, public HTTP(S) URL, or Base64 data URL. Local masks must match a local raster source's dimensions and contain only pure black and white pixels. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string ("recraftv3" | "recraftv3_vector") | No | V3 raster or V3 vector; these are the only models this operation supports. |
| `style` | string | No | Optional V3 curated style name. |
| `prompt` | string | Yes | Description of the new content. |
| `controls` | object | No | Optional V3 color, background, artistic, and text controls. |
| `style_id` | string | No | Optional custom V3 style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string | No | V3 style matching mode; only regular is supported. |
| `text_layout` | array | No | Optional V3 text elements and their four-point polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |
| `negative_prompt` | string | No | Content the result must not contain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Raster Image

**Slug:** `RECRAFT_GENERATE_RASTER_IMAGE`

Generate one to six raster images with a documented raster model and return public signed URLs through Recraft's raster-only endpoint, which rejects vector output. Use this when raster output must be provider-enforced. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to generate, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `size` | string ("1024x1024" | "1365x1024" | "1024x1365" | "1536x1024" | "1024x1536" | "1820x1024" | "1024x1820" | "1024x2048" | "2048x1024" | "1434x1024" | "1024x1434" | "1024x1280" | "1280x1024" | "1024x1707" | "1707x1024" | "1216x896" | "896x1216" | "1280x832" | "832x1280" | "1152x896" | "896x1152" | "1280x896" | "896x1280" | "832x1344" | "768x1344" | "1344x768" | "768x1536" | "1536x768" | "2048x2048" | "2432x1792" | "1792x2432" | "2560x1664" | "1664x2560" | "2304x1792" | "1792x2304" | "2560x1792" | "1792x2560" | "1664x2688" | "1536x2688" | "2688x1536" | "1536x3072" | "3072x1536" | "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") | No | Output aspect ratio w:h, supported by every model, or a documented exact WxH size compatible with the selected raster model. Vector models accept ratios only. |
| `model` | string ("recraftv2" | "recraftv2_raster" | "recraftv3" | "recraftv3_raster" | "recraftv4" | "recraftv4_raster" | "recraftv4_pro" | "recraftv4_pro_raster" | "recraftv4_1" | "recraftv4_1_raster" | "recraftv4_1_pro" | "recraftv4_1_pro_raster" | "recraftv4_1_utility" | "recraftv4_1_utility_raster" | "recraftv4_1_utility_pro" | "recraftv4_1_utility_pro_raster" | "recraftv4_styles" | "recraftv4_styles_raster" | "recraftv4_styles_pro" | "recraftv4_styles_pro_raster" | "recraftv4_1_flash" | "recraftv4_1_flash_raster") | No | Optional Recraft generation model. Omit it for recraftv4_1, or recraftv4_styles when style_reference_urls are supplied. External models are not accepted. |
| `style` | string | No | Optional model-compatible curated style name. |
| `prompt` | string | Yes | Text description of the desired images; V2/V3 allow up to 1,000 characters and newer models up to 10,000. |
| `upscale` | string ("upscale4mp" | "upscale16mp") | No | Optional provider generation upscale mode. |
| `controls` | object | No | Optional generation controls. |
| `style_id` | string | No | Optional compatible custom style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string ("regular" | "precise" | "flexible") | No | Style matching mode: regular for V2/V3, or flexible/precise for V4/V4.1. |
| `text_layout` | array | No | V3-only words and four-point placement polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; vector output is always SVG. |
| `negative_prompt` | string | No | V2/V3-only description of undesired content. |
| `style_reference_urls` | array | No | One to ten PNG, JPEG, or WebP style references as protected Composio uploads, public HTTP(S) URLs, or Base64 image data URLs. Local content must be under 20 MB per image and at most 64 MB in total. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate Vector Image

**Slug:** `RECRAFT_GENERATE_VECTOR_IMAGE`

Generate one to six SVG images with a documented vector model and return public signed URLs through Recraft's vector-only endpoint, which rejects raster output. Use this when SVG output must be provider-enforced. Treat the SVG as untrusted active content. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to generate, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `size` | string ("1024x1024" | "1365x1024" | "1024x1365" | "1536x1024" | "1024x1536" | "1820x1024" | "1024x1820" | "1024x2048" | "2048x1024" | "1434x1024" | "1024x1434" | "1024x1280" | "1280x1024" | "1024x1707" | "1707x1024" | "1216x896" | "896x1216" | "1280x832" | "832x1280" | "1152x896" | "896x1152" | "1280x896" | "896x1280" | "832x1344" | "768x1344" | "1344x768" | "768x1536" | "1536x768" | "2048x2048" | "2432x1792" | "1792x2432" | "2560x1664" | "1664x2560" | "2304x1792" | "1792x2304" | "2560x1792" | "1792x2560" | "1664x2688" | "1536x2688" | "2688x1536" | "1536x3072" | "3072x1536" | "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") | No | Output aspect ratio w:h, supported by every model, or a documented exact WxH size compatible with the selected raster model. Vector models accept ratios only. |
| `model` | string ("recraftv2_vector" | "recraftv3_vector" | "recraftv4_vector" | "recraftv4_pro_vector" | "recraftv4_1_vector" | "recraftv4_1_pro_vector" | "recraftv4_1_utility_vector" | "recraftv4_1_utility_pro_vector" | "recraftv4_styles_vector" | "recraftv4_styles_pro_vector") | No | Optional Recraft generation model. Omit it for recraftv4_1, or recraftv4_styles when style_reference_urls are supplied. External models are not accepted. |
| `style` | string | No | Optional model-compatible curated style name. |
| `prompt` | string | Yes | Text description of the desired images; V2/V3 allow up to 1,000 characters and newer models up to 10,000. |
| `upscale` | string ("upscale4mp" | "upscale16mp") | No | Optional provider generation upscale mode. |
| `controls` | object | No | Optional generation controls. |
| `style_id` | string | No | Optional compatible custom style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string ("regular" | "precise" | "flexible") | No | Style matching mode: regular for V2/V3, or flexible/precise for V4/V4.1. |
| `text_layout` | array | No | V3-only words and four-point placement polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; vector output is always SVG. |
| `negative_prompt` | string | No | V2/V3-only description of undesired content. |
| `style_reference_urls` | array | No | One to ten PNG, JPEG, or WebP style references as protected Composio uploads, public HTTP(S) URLs, or Base64 image data URLs. Local content must be under 20 MB per image and at most 64 MB in total. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `RECRAFT_GET_CURRENT_USER`

Get the connected Recraft user's identity and remaining API Units balance. This endpoint is self-only and cannot inspect another user.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Custom Style

**Slug:** `RECRAFT_GET_STYLE`

Get one connected-account Recraft style by UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `style_id` | string | Yes | UUID of a style accessible to the connected Recraft account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Transform Image From Prompt

**Slug:** `RECRAFT_IMAGE_TO_IMAGE`

Create one to six new images from a source image and prompt with controlled similarity. Supports Recraft V3, V4, and V4.1 but not V2, Flash, dedicated Styles, or external models. SVG inputs and outputs are untrusted. This paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to create, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string ("recraftv3" | "recraftv3_raster" | "recraftv3_vector" | "recraftv4" | "recraftv4_raster" | "recraftv4_vector" | "recraftv4_pro" | "recraftv4_pro_raster" | "recraftv4_pro_vector" | "recraftv4_1" | "recraftv4_1_raster" | "recraftv4_1_vector" | "recraftv4_1_pro" | "recraftv4_1_pro_raster" | "recraftv4_1_pro_vector" | "recraftv4_1_utility" | "recraftv4_1_utility_raster" | "recraftv4_1_utility_vector" | "recraftv4_1_utility_pro" | "recraftv4_1_utility_pro_raster" | "recraftv4_1_utility_pro_vector") | No | Supported V3, V4, or V4.1 model; V2, Flash, and external models are excluded. |
| `style` | string | No | Optional V3 curated style name. |
| `prompt` | string | Yes | Description of the desired changes. |
| `controls` | object | No | Generation controls. |
| `strength` | number | Yes | How far to move from the source, from 0 to 1. |
| `style_id` | string | No | Optional custom style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string | No | V3 custom-style matching mode; only regular is supported. |
| `text_layout` | array | No | V3-only text layout. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |
| `negative_prompt` | string | No | V3-only undesired content. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Inpaint Image

**Slug:** `RECRAFT_INPAINT_IMAGE`

Regenerate the pure-white masked area of one image from a prompt, keeping black areas unchanged. Produces one to six V3 raster or untrusted V3 SVG results in one paid, non-retried request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to create, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `mask` | string | Yes | Grayscale PNG, JPEG, or WebP mask as a protected upload, public HTTP(S) URL, or Base64 data URL. Local masks must match a local raster source's dimensions and contain only pure black and white pixels. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string ("recraftv3" | "recraftv3_vector") | No | V3 raster or V3 vector; these are the only models this operation supports. |
| `style` | string | No | Optional V3 curated style name. |
| `prompt` | string | Yes | Description of the new content. |
| `controls` | object | No | Optional V3 color, background, artistic, and text controls. |
| `style_id` | string | No | Optional custom V3 style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string | No | V3 style matching mode; only regular is supported. |
| `text_layout` | array | No | Optional V3 text elements and their four-point polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |
| `negative_prompt` | string | No | Content the result must not contain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Basic Styles

**Slug:** `RECRAFT_LIST_BASIC_STYLES`

List Recraft's built-in styles and the compatible model for each. The provider returns the complete list without pagination.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Custom Styles

**Slug:** `RECRAFT_LIST_STYLES`

List all custom styles created in the connected Recraft account. The provider returns the complete list without pagination.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Outpaint Image

**Slug:** `RECRAFT_OUTPAINT_IMAGE`

Extend one image beyond its borders using a prompt and an output size, side expansion, or zoom-out percentage. Produces one to six V3 raster or untrusted V3 SVG results in one paid, non-retried request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to create, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `size` | string ("1024x1024" | "2048x1024" | "1024x2048" | "1536x1024" | "1024x1536" | "1365x1024" | "1024x1365" | "1280x1024" | "1024x1280" | "1024x1707" | "1434x1024" | "1024x1434" | "1820x1024" | "1024x1820" | "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") | No | Supported V3 output ratio or exact size; cannot accompany expand fields. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string ("recraftv3" | "recraftv3_vector") | No | V3 raster or V3 vector; these are the only models this operation supports. |
| `style` | string | No | Optional V3 curated style name. |
| `prompt` | string | Yes | Description of the new content. |
| `controls` | object | No | Optional V3 color, background, artistic, and text controls. |
| `style_id` | string | No | Optional custom V3 style identifier. |
| `expand_top` | integer | No | Pixels to add above, from 0 to 4096. |
| `expand_left` | integer | No | Pixels to add on the left, from 0 to 4096. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string | No | V3 style matching mode; only regular is supported. |
| `text_layout` | array | No | Optional V3 text elements and their four-point polygons. |
| `expand_right` | integer | No | Pixels to add on the right, from 0 to 4096. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |
| `expand_bottom` | integer | No | Pixels to add below, from 0 to 4096. |
| `negative_prompt` | string | No | Content the result must not contain. |
| `zoom_out_percentage` | number | No | Percentage to scale down the source before extending, from 0 below 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Image Background

**Slug:** `RECRAFT_REMOVE_IMAGE_BACKGROUND`

Remove the background from one raster or SVG image and return a public signed result URL that normally expires in about 24 hours. This duration is not guaranteed; download durable results promptly. SVG remains untrusted. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio file upload, public HTTP(S) URL, or Base64 image data URL. Local raster content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels; local SVG bytes remain unparsed and unrendered. |
| `image_format` | string ("webp" | "png") | No | Raster output format. Omit for Recraft's lossless WebP default. Recraft ignores this setting for SVG output. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Replace Image Background

**Slug:** `RECRAFT_REPLACE_IMAGE_BACKGROUND`

Detect and redraw one image's background from a prompt. Produces one to six V3 raster or untrusted V3 SVG results in one paid request without automatic HTTP retries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of images to create, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string ("recraftv3" | "recraftv3_vector") | No | V3 raster or V3 vector; these are the only models this operation supports. |
| `style` | string | No | Optional V3 curated style name. |
| `prompt` | string | Yes | Description of the new content. |
| `controls` | object | No | Optional V3 color, background, artistic, and text controls. |
| `style_id` | string | No | Optional custom V3 style identifier. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `style_match` | string | No | V3 style matching mode; only regular is supported. |
| `text_layout` | array | No | Optional V3 text elements and their four-point polygons. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |
| `negative_prompt` | string | No | Content the result must not contain. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remix Image

**Slug:** `RECRAFT_VARIATE_IMAGE`

Create one to six prompt-free variations of an image at a required supported aspect ratio or model-compatible exact size. Accepts current Recraft models from the official API, but no external models; SVG content is untrusted. This paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `n` | integer | No | Number of variations, from 1 to 6. |
| `zdr` | boolean | No | Request zero data retention. |
| `size` | string ("1024x1024" | "1365x1024" | "1024x1365" | "1536x1024" | "1024x1536" | "1820x1024" | "1024x1820" | "1024x2048" | "2048x1024" | "1434x1024" | "1024x1434" | "1024x1280" | "1280x1024" | "1024x1707" | "1707x1024" | "1216x896" | "896x1216" | "1280x832" | "832x1280" | "1152x896" | "896x1152" | "1280x896" | "896x1280" | "832x1344" | "768x1344" | "1344x768" | "768x1536" | "1536x768" | "2048x2048" | "2432x1792" | "1792x2432" | "2560x1664" | "1664x2560" | "2304x1792" | "1792x2304" | "2560x1792" | "1792x2560" | "1664x2688" | "1536x2688" | "2688x1536" | "1536x3072" | "3072x1536" | "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") | Yes | Required documented aspect ratio or exact WxH size. |
| `image` | string | Yes | Source PNG, JPEG, WebP, or opaque untrusted SVG as a protected Composio upload, public HTTP(S) URL, or Base64 data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `model` | string | No | Optional current Recraft model from the official API; external models are excluded. |
| `random_seed` | integer | No | Optional unsigned 32-bit seed. |
| `image_format` | string ("webp" | "png") | No | Raster output format; ignored for SVG output. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Vectorize Image

**Slug:** `RECRAFT_VECTORIZE_IMAGE`

Convert one PNG, JPEG, or WebP raster image into an editable SVG and return a public signed URL that normally expires in about 24 hours. This duration is not guaranteed; download durable results promptly and treat the SVG as untrusted. The paid operation is sent once and is not automatically retried.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image` | string | Yes | Source PNG, JPEG, or WebP as a protected Composio file upload, public HTTP(S) URL, or Base64 image data URL. Local content must be under 20 MB, 256-4096 px per side, and no more than 16 megapixels. |
| `shape_stacking` | string ("hierarchical" | "cut_out") | No | How SVG shapes overlap: hierarchical allows stacked shapes; cut_out removes covered portions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |