---
title: Recraft V4.1 | Runware Docs
url: https://runware.ai/docs/models/recraft-v4-1
description: Sharper design-focused image generation for everyday creative work and iteration
---
# Recraft V4.1

![Recraft V4.1](https://assets.runware.ai/covers/recraft-v4-1.jpg)

Recraft V4.1 is the standard raster model in the Recraft V4.1 family for professional image generation and editing. It improves the V4 line with cleaner photorealism, sharper object understanding, smoother gradients and 3D rendering, cleaner icons and vectors by default, and better results from shorter prompts, while staying faster and more cost-efficient than the Pro variant.

- **Status**: live
- **ID**: `recraft:v4.1@0`
- Try in Playground
- **Creator**: Recraft
- **Release Date**: May 14, 2026
- **Capabilities**: Text to Image, Checkpoint

## Pricing

$0.035 per run · ~10s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/recraft-v4-1/examples#example-period-conspiracy-series-poster): `$0.035` (~16s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1/examples#example-animated-adventure-streaming-poster): `$0.035` (~8s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1/examples#example-geothermal-field-crew-sticker-pack): `$0.035` (~9s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1/examples#example-artisan-glassworks-game-key-art): `$0.035` (~11s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (1:1)` | `1024x1024` |
| `1K (2:1)` | `1536x768` |
| `1K (1:2)` | `768x1536` |
| `1K (3:2)` | `1280x832` |
| `1K (2:3)` | `832x1280` |
| `1K (4:3)` | `1216x896` |
| `1K (3:4)` | `896x1216` |
| `1K (5:4)` | `1152x896` |
| `1K (4:5)` | `896x1152` |
| `1K (6:10)` | `832x1344` |
| `1K (14:10)` | `1280x896` |
| `1K (10:14)` | `896x1280` |
| `1K (16:9)` | `1344x768` |
| `1K (9:16)` | `768x1344` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/recraft-v4-1#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/recraft-v4-1#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/recraft-v4-1#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/recraft-v4-1#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/recraft-v4-1#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/recraft-v4-1#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/recraft-v4-1#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/recraft-v4-1#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/recraft-v4-1#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/recraft-v4-1#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/recraft-v4-1#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/recraft-v4-1#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/recraft-v4-1#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/recraft-v4-1#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `recraft:v4.1@0`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/recraft-v4-1#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `10000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/recraft-v4-1#request-width)

- **Type**: `integer`
- **Required**: true
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/recraft-v4-1#request-height)

- **Type**: `integer`
- **Required**: true
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [backgroundColor](https://runware.ai/docs/models/recraft-v4-1#request-settings-backgroundcolor)

- **Path**: `settings.backgroundColor`
- **Type**: `object (1 property)`

Background color used for the generation.

**Learn more** (1 resource):

- [Color Palettes](https://runware.ai/docs/models/recraft-v4-1/guides/color-palettes) (learn)

#### [rgb](https://runware.ai/docs/models/recraft-v4-1#request-settings-backgroundcolor-rgb)

- **Path**: `settings.backgroundColor.rgb`
- **Type**: `array of integers`
- **Required**: true
- **Min**: `0`
- **Max**: `255`
- **Min items**: `items: 3`

Color as `[red, green, blue]` array.

### [colors](https://runware.ai/docs/models/recraft-v4-1#request-settings-colors)

- **Path**: `settings.colors`
- **Type**: `array of objects (1 property)`

Colors defining the palette for the generation.

**Learn more** (1 resource):

- [Color Palettes](https://runware.ai/docs/models/recraft-v4-1/guides/color-palettes) (learn)

#### [rgb](https://runware.ai/docs/models/recraft-v4-1#request-settings-colors-rgb)

- **Path**: `settings.colors.rgb`
- **Type**: `array of integers`
- **Required**: true
- **Min**: `0`
- **Max**: `255`
- **Min items**: `items: 3`

Color as `[red, green, blue]` array.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/recraft-v4-1#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/recraft-v4-1#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/recraft-v4-1#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/recraft-v4-1#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/recraft-v4-1#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/recraft-v4-1#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/recraft-v4-1#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [NSFWContent](https://runware.ai/docs/models/recraft-v4-1#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/recraft-v4-1#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-image (text-to-image)

![Period Conspiracy Series Poster](https://assets.runware.ai/examples/recraft-v4-1/6dfeb136-728f-44d4-962a-96230b7b0e5a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "a1ed0897-7a37-417a-831a-e8af983c756c",
  "model": "recraft:v4.1@0",
  "positivePrompt": "Finished square streaming-series poster for a fictional prestige conspiracy thriller titled “THE LAST SWITCHBOARD.” Central focal subject: a poised female telephone operator in 1968, shown waist-up and facing the viewer, wearing a period cream blouse, dark cat-eye glasses, and a single vintage telephone headset. Her wary expression suggests she has just overheard something dangerous. Behind her, a monumental manual switchboard fills the composition; dozens of black cables and brass plugs radiate toward her like a tense geometric web, with one vivid red cord leading to a small blinking line indicator. Subtle silhouettes of two suited men appear behind the perforated switchboard panels, ambiguous and threatening. Art direction combines polished cinematic portrait photography with crisp mid-century editorial poster design, strong symmetry, controlled negative space, slight screen-printed texture, sharp facial detail, smooth tonal gradients, and dramatic hard-edged lighting. Deliberate warm high-contrast palette: burnt orange, saffron yellow, warm ivory, vivid signal red, and near-black against a deep oxblood background. Add large, clean, condensed ivory title typography at the bottom: “THE LAST SWITCHBOARD”; above it in small uppercase letters: “A LIMITED SERIES”; minimal fictional billing line beneath. Premium, intelligent, suspenseful, historically credible, uncluttered composition, instantly legible at streaming-thumbnail size, no logos, no interface, no mockup, no border.",
  "width": 1024,
  "height": 1024,
  "settings": {
    "backgroundColor": {
      "rgb": [
        245,
        240,
        230
      ]
    },
    "colors": [
      {
        "rgb": [
          20,
          52,
          74
        ]
      },
      {
        "rgb": [
          226,
          93,
          58
        ]
      },
      {
        "rgb": [
          242,
          185,
          60
        ]
      }
    ]
  }
}
```

---

### text-to-image (text-to-image)

![Animated Adventure Streaming Poster](https://assets.runware.ai/examples/recraft-v4-1/206c8c40-05dd-4a7a-9d3c-d1d506b7ec21.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "267344c7-c395-4267-97c8-34ebc2280a24",
  "model": "recraft:v4.1@0",
  "positivePrompt": "Finished square streaming poster for an original stop-motion animated adventure titled “NIGHT POST.” A determined pangolin night courier is the distinctive central hero, riding a compact vintage red motor scooter directly toward the viewer, articulated scales catching sharp golden rim light, canvas mail satchel overflowing with sealed envelopes. Behind the courier, a vast subterranean postal city spirals downward through terracotta tunnels: tiny sorting balconies, brass chutes, suspended bridges, glowing windows and streams of airborne letters create depth and motion. Cinematic low-angle composition, bold triangular silhouette, expressive handcrafted character design, tactile miniature sets, subtle clay and paper textures, sophisticated family-film appeal rather than childish cartoon styling. Deliberate warm high-contrast palette using saturated saffron, vermilion, burnt orange, parchment cream and deep near-black shadows, integrated naturally with the supplied background color. Strong highlights, dramatic shadows, crisp focal detail, atmospheric falloff, premium theatrical lighting. Large legible custom title NIGHT POST across the upper third in chunky cream-colored letterforms inspired by vintage postal stamps, with enough clear space around the lettering; no other text, no logos, no border, no mockup, one polished standalone poster image.",
  "width": 1024,
  "height": 1024,
  "settings": {
    "backgroundColor": {
      "rgb": [
        245,
        240,
        230
      ]
    },
    "colors": [
      {
        "rgb": [
          20,
          52,
          74
        ]
      },
      {
        "rgb": [
          226,
          93,
          58
        ]
      },
      {
        "rgb": [
          242,
          185,
          60
        ]
      }
    ]
  }
}
```

---

### text-to-image (text-to-image)

![Geothermal Field Crew Sticker Pack](https://assets.runware.ai/examples/recraft-v4-1/b7acbc2d-ba88-4a84-b260-540120b4d361.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "887eb9bd-0cb9-4b13-af0e-4e27dfdd895a",
  "model": "recraft:v4.1@0",
  "positivePrompt": "A polished square sticker pack for a geothermal energy field crew, presented as one clean sticker sheet with nine separate die-cut designs. Central focal sticker: a confident fire salamander mascot wearing rugged utility coveralls, safety goggles, gloves, and work boots, holding a round pressure gauge beside a curl of geothermal steam. Surrounding stickers: a geothermal drill bit cutting through layered rock, a steam separator vessel, crossed pipe wrenches, a wellhead valve, heat-resistant gloves, a seismograph line over underground strata, a turbine rotor, and a hard hat containing a small hot-spring symbol. Bold simplified vector illustration, crisp geometric construction, thick dark outlines, smooth curves, subtle dimensional shading, consistent icon language, generous cream-colored die-cut borders around every sticker. Deliberately use the supplied warm high-contrast palette and background color throughout. Strong visual hierarchy, evenly balanced radial arrangement, ample separation between stickers, professional industrial character with a friendly modern mascot, no lettering, no logos, no extra objects, no photographic mockup, straight-on view, print-ready finish.",
  "width": 1024,
  "height": 1024,
  "settings": {
    "backgroundColor": {
      "rgb": [
        245,
        240,
        230
      ]
    },
    "colors": [
      {
        "rgb": [
          20,
          52,
          74
        ]
      },
      {
        "rgb": [
          226,
          93,
          58
        ]
      },
      {
        "rgb": [
          242,
          185,
          60
        ]
      }
    ]
  }
}
```

---

### text-to-image (text-to-image)

![Artisan Glassworks Game Key Art](https://assets.runware.ai/examples/recraft-v4-1/040c4517-4240-47f9-9963-40cd056dbe06.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "de76be18-f3f6-4cdb-bd91-5a9b9bff0bf6",
  "model": "recraft:v4.1@0",
  "positivePrompt": "Premium square key art for an action-crafting video game set inside a working volcanic glass foundry. The central hero is a determined master glassblower wearing a soot-dark leather apron, heavy gauntlets and an amber heat visor, planted in a powerful three-quarter stance while swinging a long steel blowpipe. At the end of the pipe, a radiant mass of molten glass is being shaped into a huge translucent salamander that coils overhead in a dramatic S-curve. Make the transformation physically convincing: viscous glowing strands still connect the creature to the pipe, with trapped bubbles, stretched glass, tool marks and bright furnace reflections visible inside its body. Frame the hero against the circular mouth of a roaring brick furnace like a halo; surround them with recognizable glassmaking equipment, iron molds, shears, workbenches and distant catwalk silhouettes. Low cinematic viewpoint, bold readable silhouette, controlled diagonal movement, clear central focal point and uncluttered corners suitable for a digital game storefront tile. Stylized high-end 3D illustration with handcrafted maquette character design, tactile materials, sharp object definition, smooth glow gradients and polished AAA game key-art lighting. Deliberate warm high-contrast palette: luminous cream, saffron, amber, vermilion and molten orange against deep charcoal and near-black brown, making purposeful use of the supplied warm palette and background color. Energetic, industrious and heroic rather than whimsical. One finished standalone image, no typography, no logo, no interface, no border, no mockup.",
  "width": 1024,
  "height": 1024,
  "settings": {
    "backgroundColor": {
      "rgb": [
        245,
        240,
        230
      ]
    },
    "colors": [
      {
        "rgb": [
          20,
          52,
          74
        ]
      },
      {
        "rgb": [
          226,
          93,
          58
        ]
      },
      {
        "rgb": [
          242,
          185,
          60
        ]
      }
    ]
  }
}
```