---
title: Recraft V4 | Runware Docs
url: https://runware.ai/docs/models/recraft-v4
description: Professional text-to-image model for brand and marketing design
---
# Recraft V4

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

Recraft V4 is a professional-grade text-to-image model built for design and marketing workflows. It focuses on refined visual aesthetics, strong photorealism, and reliable brand control. The model delivers realistic skin rendering, natural textures, distinctive lighting, and well-structured compositions while avoiding common synthetic artifacts. It supports 2K image generation, color palette control, and explicit background color selection to help teams produce brand-consistent creative assets.

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

## Pricing

$0.04 per run · ~15s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/recraft-v4/examples#example-urban-infrastructure-magazine-cover): `$0.04` (~13s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4/examples#example-cubesat-deorbit-explainer-infographic): `$0.04` (~18s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4/examples#example-subsea-cable-repair-video-thumbnail): `$0.04` (~16s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4/examples#example-technical-apiary-workwear-lookbook): `$0.04` (~14s)

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#request-tasktype)

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

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/recraft-v4#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#request-outputtype)

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

Image output type.

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

### [outputFormat](https://runware.ai/docs/models/recraft-v4#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#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#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#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#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#request-safety)

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

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/recraft-v4#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#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#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/recraft-v4#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#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `recraft:v4@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#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#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#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#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#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#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#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#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#request-advancedfeatures-watermark-text)

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

Watermark text.

#### [image](https://runware.ai/docs/models/recraft-v4#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#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#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#request-advancedfeatures-watermark-fontcolor)

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

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/recraft-v4#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#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#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#response-imageuuid)

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/recraft-v4#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)

![Urban Infrastructure Magazine Cover](https://assets.runware.ai/examples/recraft-v4/049faffa-eba4-4dbe-a7ac-9179c70644d6.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "c4978b99-74d0-4815-a757-2cbb03067a15",
  "model": "recraft:v4@0",
  "positivePrompt": "Finished square magazine cover, edge-to-edge artwork rather than a physical mockup. Create a sophisticated editorial cover for NIGHT SHIFT, a publication about the hidden systems and workers that keep cities running after dark. Center the composition on a precise axonometric cutaway of one dense urban block at midnight: street level with a nearly empty intersection, glowing bus shelter, delivery cyclist and sanitation crew; below ground, clearly layered subway tunnel, water main, electrical conduit, fiber cables and maintenance corridors, with tiny workers performing believable tasks. Render the infrastructure as a crisp architectural editorial illustration combining clean vector geometry, subtle dimensional shading and meticulous technical detail. Strong visual hierarchy, generous negative space, disciplined grid and polished contemporary art direction. Midnight navy field with safety orange machinery, electric cyan utility lines, warm ivory structures and restrained signal-red accents. Dramatic pools of artificial light punctuate the dark composition. Add only this clean, legible cover typography: large condensed sans-serif masthead “NIGHT SHIFT” across the top; main feature line “THE INVISIBLE CITY” in the lower-left; small line “ISSUE 07 / INFRASTRUCTURE” beneath it. Typography should feel integrated, sharply typeset and editorial, with no other words, logos, barcodes or decorative filler. Premium independent architecture and urbanism magazine aesthetic, intelligent, technical, cinematic, crisp print-ready detail.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "recraft": {
      "backgroundColor": {
        "rgb": [
          245,
          242,
          234
        ]
      },
      "colors": [
        {
          "rgb": [
            22,
            42,
            66
          ]
        },
        {
          "rgb": [
            235,
            99,
            82
          ]
        },
        {
          "rgb": [
            87,
            181,
            166
          ]
        }
      ]
    }
  }
}
```

---

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

![CubeSat Deorbit Explainer Infographic](https://assets.runware.ai/examples/recraft-v4/ba8811cb-1003-486d-9b2e-70a11cc358f5.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "c92d8280-5316-4d19-8c44-b61c8083fcd3",
  "model": "recraft:v4@0",
  "positivePrompt": "Create a finished, design-forward square infographic titled “HOW A CUBESAT COMES HOME,” explaining the end-of-life deorbit process for a small satellite equipped with a drag sail. Use a sophisticated aerospace editorial style combining crisp vector geometry, precise technical illustration, subtle dimensional shading, and polished screen-print texture. Deep midnight-navy background with a restrained palette of electric cyan, acid lime, safety orange, warm ivory, and muted steel blue.\n\nComposition: a large diagonal orbital path sweeps from the upper-left toward the curved edge of Earth in the lower-right. Show one consistent CubeSat at four clearly separated stages along the path, connected by clean arrows and numbered circles. Stage 1: compact CubeSat in low Earth orbit, labeled “1  MISSION ENDS” with the short caption “SYSTEMS POWER DOWN.” Stage 2: the same CubeSat opening a large cross-shaped reflective drag sail, labeled “2  DEPLOY SAIL” with “A WIDER PROFILE MEETS THIN AIR.” Stage 3: the spacecraft following a tightening, descending orbit, labeled “3  ORBIT DECAYS” with “ATMOSPHERIC DRAG LOWERS ALTITUDE.” Stage 4: a small controlled-looking atmospheric breakup trail above Earth, labeled “4  CLEAN REENTRY” with “COMPONENTS BURN UP HIGH ABOVE THE SURFACE.”\n\nInclude three subtle altitude bands around Earth labeled “LOW EARTH ORBIT,” “UPPER ATMOSPHERE,” and “REENTRY ZONE.” Add a compact footer key reading “DRAG SAIL • PASSIVE DEORBIT DEVICE” beside a simple sail icon. Make the hierarchy instantly understandable: bold condensed sans-serif title, large numbers, concise uppercase labels, very limited supporting copy, generous spacing, disciplined alignment, and strong contrast. Render the CubeSat with believable solar cells, metallic rails, hinges, antenna details, and a thin iridescent sail membrane. Earth should be a simplified scientific cutaway rather than a photorealistic globe, with narrow luminous atmospheric layers and sparse contour lines. Deliberate palette use: cyan for orbit paths and technical lines, acid lime for the deployed sail and stage numbers, orange only for the reentry trail, ivory for typography, steel blue for Earth. Crisp edges, accurate perspective, premium museum-science graphic quality, no logos, no app interface, no browser frame, no buttons, no decorative fantasy elements, no extra paragraphs, no clutter.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "recraft": {
      "backgroundColor": {
        "rgb": [
          245,
          242,
          234
        ]
      },
      "colors": [
        {
          "rgb": [
            22,
            42,
            66
          ]
        },
        {
          "rgb": [
            235,
            99,
            82
          ]
        },
        {
          "rgb": [
            87,
            181,
            166
          ]
        }
      ]
    }
  }
}
```

---

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

![Subsea Cable Repair Video Thumbnail](https://assets.runware.ai/examples/recraft-v4/3deae9fe-d352-412c-a334-cca71ec8c878.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "07c7a613-45ef-4b26-90f3-9731733eba26",
  "model": "recraft:v4@0",
  "positivePrompt": "Design-forward square video thumbnail for a premium engineering documentary about deep-sea fiber-optic cable repair. A large white robotic submersible manipulator grips a severed black armored cable in the foreground, exposing a precise bundle of hair-thin glowing cyan optical fibers. Tiny suspended particles reveal the immense depth. In the middle distance, a compact repair ROV aims two sharp work lights through the darkness. Strong diagonal composition, oversized cable and claw readable instantly at thumbnail size, dramatic sense of scale, crisp mechanical detail, realistic metal, rubber, sediment, and glass-fiber textures. Refined editorial photorealism with subtle technical-illustration clarity. Deliberate restricted palette: abyssal navy background, electric cyan fiber glow, safety orange equipment accents, cool ivory work lights, small touches of muted steel gray. High contrast rim lighting, controlled volumetric beams, clean negative space in the upper left, polished documentary key art, tense and intelligent rather than fantastical. No people, no lettering, no numbers, no logos, no watermark, no interface, no border, no mockup.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "recraft": {
      "backgroundColor": {
        "rgb": [
          245,
          242,
          234
        ]
      },
      "colors": [
        {
          "rgb": [
            22,
            42,
            66
          ]
        },
        {
          "rgb": [
            235,
            99,
            82
          ]
        },
        {
          "rgb": [
            87,
            181,
            166
          ]
        }
      ]
    }
  }
}
```

---

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

![Technical Apiary Workwear Lookbook](https://assets.runware.ai/examples/recraft-v4/0aee66ea-0eed-4bd6-ace2-d139a9d1b9d6.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "9967fe4a-70bc-43d8-8a32-1f0cae54915a",
  "model": "recraft:v4@0",
  "positivePrompt": "High-end editorial fashion lookbook photograph for a design-led professional apiary workwear collection. Full-length portrait of one androgynous adult model standing in a confident, relaxed contrapposto pose, centered with ample negative space, facing the camera. The model wears a meticulously tailored bone-white ripstop beekeeping jumpsuit with articulated knees, reinforced utility pockets, precise tonal stitching, a sculptural detachable black mesh veil with a wide circular brim, cobalt-blue harness webbing, acid-chartreuse gauntlet gloves, and polished oxblood rubber field boots. A brushed stainless-steel bee smoker hangs naturally from one hand as a restrained occupational prop. Garments must appear functional, premium, and realistically constructed, with crisp seams, believable closures, subtle fabric creasing, visible mesh texture, and accurate human anatomy. Deep aubergine seamless studio cyclorama, matte floor, clean background with no set clutter. Hard directional key light creates a sharp geometric shadow across the backdrop, balanced by soft frontal fill for natural skin and clear garment detail. Sophisticated utilitarian art direction, contemporary European workwear catalog, polished composition, medium-format fashion photography, realistic skin texture, controlled color blocking, crisp focus from veil to boots, no bees, no flowers, no text, no logos, no watermark, no collage, no border.",
  "width": 1024,
  "height": 1024,
  "providerSettings": {
    "recraft": {
      "backgroundColor": {
        "rgb": [
          245,
          242,
          234
        ]
      },
      "colors": [
        {
          "rgb": [
            22,
            42,
            66
          ]
        },
        {
          "rgb": [
            235,
            99,
            82
          ]
        },
        {
          "rgb": [
            87,
            181,
            166
          ]
        }
      ]
    }
  }
}
```