---
title: Recraft V4 Pro | Runware Docs
url: https://runware.ai/docs/models/recraft-v4-pro
description: Advanced design-focused image generation with enhanced control and fidelity
---
# Recraft V4 Pro

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

Recraft V4 Pro is an advanced text-to-image model tailored for high-end creative production and brand-critical design work. It delivers elevated photorealism, nuanced lighting, refined composition, and contemporary styling suited for professional campaigns. The model provides enhanced control over color palettes, background colors, and style references, enabling precise brand alignment at 2K resolution. It is built to produce distinctive visuals with consistent aesthetic quality across marketing, advertising, and product-focused content.

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

## Pricing

$0.25 per run · ~17s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/recraft-v4-pro/examples#example-semiconductor-fab-manga-cover-art): `$0.25` (~19s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-pro/examples#example-urban-archaeology-magazine-cover): `$0.25` (~17s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-pro/examples#example-oyster-farm-salinity-meter-campaign): `$0.25` (~18s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-pro/examples#example-urban-bat-roost-retrofit-illustration): `$0.25` (~15s)

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 |
| --- | --- |
| `2K (1:1)` | `2048x2048` |
| `2K (2:1)` | `3072x1536` |
| `2K (1:2)` | `1536x3072` |
| `2K (3:2)` | `2560x1664` |
| `2K (2:3)` | `1664x2560` |
| `2K (4:3)` | `2432x1792` |
| `2K (3:4)` | `1792x2432` |
| `2K (5:4)` | `2304x1792` |
| `2K (4:5)` | `1792x2304` |
| `2K (6:10)` | `1664x2688` |
| `2K (14:10)` | `2560x1792` |
| `2K (10:14)` | `1792x2560` |
| `2K (16:9)` | `2688x1536` |
| `2K (9:16)` | `1536x2688` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

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

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

Identifier for the type of task being performed.

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

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

Image output type.

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

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

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

Content safety checking configuration for image generation.

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

- **Type**: `boolean`

Include task cost in the response.

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

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

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

Watermark text.

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

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

Text color in hex format.

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

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

![Semiconductor Fab Manga Cover Art](https://assets.runware.ai/examples/recraft-v4-pro/e1cb20d0-0814-41ac-80aa-5d190f0a8e70.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "50f1d518-29f8-4102-8156-326787a770bf",
  "model": "recraft:v4-pro@0",
  "positivePrompt": "Original polished manga-inspired digital editorial illustration for a semiconductor industry publication. Inside a vast, immaculate wafer fabrication cleanroom at midnight, a lone maintenance engineer in a realistic white hooded cleanroom suit kneels beside an opened precision lithography module, carefully adjusting a glowing optical assembly with a slim calibration tool. Her focused eyes are visible through the clear face shield, forming the unmistakable focal point. Towering rows of advanced fabrication machines recede into the distance beneath repeating amber ceiling lights; overhead robotic rails carry sealed wafer pods, and polished floor panels catch restrained reflections. Compose as a cinematic square image with the engineer and illuminated machine in the lower-center foreground, strong architectural perspective, layered depth, and generous darker space above for an editorial masthead added later. Sophisticated contemporary seinen manga art direction: confident clean linework, anatomically convincing character design, technically credible machinery, precise hard-surface details, subtle halftone texture, selective painterly rendering, crisp cel-shaded forms, atmospheric depth, and dramatic rim lighting. Quiet, intelligent, high-stakes mood rather than action spectacle. Limited palette of midnight indigo, cool cyan, warm amber, soft white, and small coral safety accents. Fine details include wafer cassettes, articulated service arms, cable conduits, filtered-air ceiling grids, warning stripes, tiny status lamps, cleanroom boot covers, and neatly arranged specialist tools. Premium magazine-cover quality, visually coherent, elegant, detailed, original character and environment, no logos, no lettering, no readable text, no interface overlay, no border, no mockup.",
  "width": 2048,
  "height": 2048,
  "providerSettings": {
    "recraft": {
      "backgroundColor": {
        "rgb": [
          12,
          19,
          43
        ]
      },
      "colors": [
        {
          "rgb": [
            12,
            19,
            43
          ]
        },
        {
          "rgb": [
            68,
            190,
            207
          ]
        },
        {
          "rgb": [
            242,
            178,
            78
          ]
        },
        {
          "rgb": [
            238,
            242,
            235
          ]
        },
        {
          "rgb": [
            226,
            99,
            88
          ]
        }
      ]
    }
  }
}
```

---

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

![Urban Archaeology Magazine Cover](https://assets.runware.ai/examples/recraft-v4-pro/33b89332-2d7b-4fd4-977d-adcee07eed6a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "748e66a3-a3f5-49fc-a5d5-9452ac991b91",
  "model": "recraft:v4-pro@0",
  "positivePrompt": "Create a finished square editorial magazine cover for MUDLARK, an independent publication about urban archaeology and material culture. Flat front-cover artwork only, not a magazine mockup. The clear focal point is a single corroded brass Georgian trade token freshly recovered from the River Thames foreshore, shown greatly enlarged in a meticulous overhead museum-style photograph. Preserve tactile archaeological detail: worn lettering, green verdigris, dark river patina, fine scratches and wet grains of silt embedded around the rim. Place the token slightly below center on a richly textured field of compacted charcoal-black tidal mud. Across the mud, subtle rivulets and mineral deposits form elegant branching patterns like a map of London waterways. Include a small fragment of cream archival evidence paper beneath one edge of the coin, carrying only a neat accession number in tiny type. Art direction: intelligent British independent magazine, contemporary archaeological field journal meets refined luxury editorial, restrained and tactile rather than rustic. Dramatic raking light from the upper left reveals relief and mud texture; soft controlled shadows, exceptional macro detail, realistic material response, crisp print-ready finish. Limited palette of near-black, oxidized copper green, tarnished brass, bone white and one sharp vermilion accent. Strong negative space in the upper quarter for the masthead. Set the masthead exactly as “MUDLARK” in large condensed bone-white uppercase sans serif letters across the top. Add a small vermilion line beneath it reading exactly “THE RIVER REMEMBERS”. Place minimal cover details in clean bone-white type: “ISSUE 08 — MATERIAL HISTORIES” at upper right and “TOKENS • TOOLS • TIDELINES” along the bottom edge. Clear typographic hierarchy, precise alignment, generous margins, no barcode, no logos, no extra text, no people, no fantasy elements. Sophisticated, quiet, mysterious and publication-ready.",
  "width": 2048,
  "height": 2048
}
```

---

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

![Oyster Farm Salinity Meter Campaign](https://assets.runware.ai/examples/recraft-v4-pro/3b7fd436-6336-43f6-b5d7-340f99e0264c.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "1ad0bd61-f8a8-4e39-9e14-684693477bd9",
  "model": "recraft:v4-pro@0",
  "positivePrompt": "High-end photorealistic commercial lifestyle photograph for a professional marine instrumentation campaign. On a working oyster farm at low tide, an oyster farmer in a weathered saffron-yellow waterproof jacket and dark teal bib overalls uses a rugged handheld salinity meter. The graphite-gray instrument is the unmistakable focal point in the near foreground: compact rectangular body, tactile rubberized corners, precise molded buttons, a clean backlit measurement display, water droplets on the casing, and a coiled cable leading to a stainless-steel probe lowered into a small seawater sample cup. The worker's orange rubber-gloved hands hold the device naturally and securely; part of their focused face is visible behind it, softly out of focus. Rows of oyster cages, wet timber racks, a practical aluminum work skiff, ropes, floats, and misty tidal flats establish the real aquaculture setting without clutter. Cool early-morning coastal light breaks through thin fog, creating restrained silver highlights on wet surfaces and a subtle warm rim light around the jacket. Intentional square composition with the meter positioned near the lower-right intersection, diagonal lines from the oyster racks drawing attention toward it, and enough environmental context to communicate field use. Contemporary documentary art direction, tactile realism, crisp product detail, nuanced skin and fabric texture, physically accurate reflections, shallow depth of field, natural atmospheric perspective, premium medium-format camera quality, 50mm lens, polished but credible, no staged studio feeling. Palette of slate blue, tidal gray, graphite, weathered wood, saffron yellow, and safety orange. No visible brand name, no advertising copy, no watermark, no decorative border.",
  "width": 2048,
  "height": 2048
}
```

---

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

![Urban Bat Roost Retrofit Illustration](https://assets.runware.ai/examples/recraft-v4-pro/6c9f9a41-6f1f-4e0e-8636-c8f5d8fabbd3.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "d9123962-453e-4b43-95f3-d397ca86790f",
  "model": "recraft:v4-pro@0",
  "positivePrompt": "Create a polished square architectural cutaway illustration for an urban ecology planning report. Show one restored Victorian red-brick railway viaduct pier and arch at dusk, viewed in a precise three-quarter axonometric composition. A clean sectional opening reveals the hidden conservation retrofit inside the masonry: stacked terracotta bat-roost chambers, narrow entry slots beneath the arch, insulated cavities, lime mortar joints, discreet rain flashing, and a protected drainage channel. Make the roost chamber the unmistakable focal point, with several small pipistrelle bats hanging naturally inside and two bats flying near the entrance for scale. Surround the structure with a restrained strip of regenerated urban habitat: ferns, foxgloves, grasses, gravel, and a shallow rain garden at the base. In the distance, suggest railway tracks and quiet warehouse silhouettes without distracting from the cutaway. Art direction: contemporary architectural editorial illustration combining highly refined 3D material realism with crisp sectional geometry, subtle paper-like grain, and carefully controlled detail. Warm terracotta brick and amber interior light contrast with deep blue-green dusk, graphite shadows, pale mineral mortar, and muted vegetation. Soft atmospheric lighting, realistic masonry texture, immaculate edges, believable construction, calm civic-design mood. Centered composition with generous breathing room, no people, no lettering, no labels, no arrows, no legend, no border, no page mockup, no interface.",
  "width": 2048,
  "height": 2048
}
```