---
title: Recraft V4.1 Utility | Runware Docs
url: https://runware.ai/docs/models/recraft-v4-1-utility
description: Controlled image generation for product shots, icons, and predictable commercial visuals
---
# Recraft V4.1 Utility

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

Recraft V4.1 Utility is the controlled-output raster model in the Recraft V4.1 family. It is designed for cases where predictability matters more than art direction, with flatter lighting, front-facing composition, and simpler scenes that make it a strong fit for product shots, icons, e-commerce imagery, and other clean commercial visuals.

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

## Pricing

$0.035 per run · ~12s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/recraft-v4-1-utility/examples#example-pipe-organ-craft-journal-cover): `$0.035` (~17s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1-utility/examples#example-oceanographic-vessel-launch-invitation): `$0.035` (~12s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1-utility/examples#example-urban-beekeeper-personal-brand-portrait): `$0.035` (~10s)
- [text-to-image](https://runware.ai/docs/models/recraft-v4-1-utility/examples#example-crop-insurance-social-campaign-visual): `$0.035` (~12s)

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-utility#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-utility#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-utility#request-outputtype)

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

Image output type.

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

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

- **Type**: `boolean`

Include task cost in the response.

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

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

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

Text color in hex format.

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

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

![Pipe Organ Craft Journal Cover](https://assets.runware.ai/examples/recraft-v4-1-utility/8625d3fa-9980-4119-96a3-fdda33ce2b33.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "f1c416bc-1cfa-4a72-a38f-f60bf3d33bf4",
  "model": "recraft:v4.1-utility@0",
  "positivePrompt": "Create a finished square magazine cover for an independent specialist journal about contemporary pipe-organ building and conservation. Front-facing, symmetrical composition featuring a precise geometric arrangement of polished organ pipes in varied lengths, simplified into bold architectural forms. Integrate subtle technical cutaway details, small tuning slots, pipe mouths, measurement ticks, and thin drafting lines without making the design busy. Swiss modernist editorial art direction with the tactile character of screen printing and cut-paper collage. Restricted palette of deep oxblood red, warm parchment, electric cobalt blue, charcoal black, and restrained brass accents. Flat even lighting, crisp edges, minimal depth, strong negative space, immaculate print-design finish. At the top, set the large clearly legible masthead: “REGISTER”. Beneath it, smaller clean sans-serif text: “PIPE ORGAN CRAFT”. Add the compact issue marker “ISSUE 07” in one corner. Typography must feel intentional, aligned to a strict grid, and integrated with the pipe geometry. Quiet, rigorous, cultured mood; contemporary rather than ecclesiastical. The image is the standalone cover artwork itself, edge to edge, not a photographed magazine, not a mockup, no hands, no table, no room scene, no barcode, no extra copy.",
  "width": 1024,
  "height": 1024
}
```

---

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

![Oceanographic Vessel Launch Invitation](https://assets.runware.ai/examples/recraft-v4-1-utility/6e16384d-f4cf-4f32-be20-db81ebceee60.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "a006b9db-3917-4c9f-a4ed-78fac31a77ec",
  "model": "recraft:v4.1-utility@0",
  "positivePrompt": "Create a polished square invitation for an oceanographic research vessel christening, presented as a finished flat graphic rather than a photographed card or mockup. Precise modern maritime art direction with a clean, front-facing composition. Center a simplified technical side-profile illustration of a white research vessel with antenna masts, compact cranes, bridge windows, and an orange hull stripe, floating on three crisp horizontal wave lines. Surround it with restrained bathymetric contour lines, tiny coordinate ticks, and a thin double-line border inspired by nautical charts. Use flat colors, sharp geometric forms, generous negative space, and highly legible typography. Palette: deep ink navy, warm off-white, pale sea cyan, and safety orange accents. Formal yet optimistic mood, suitable for a marine science institute. Set the following exact copy with clear hierarchy: “YOU’RE INVITED” at the top in small spaced capitals; “RSV TIDELINE” as the large main title; “RESEARCH VESSEL LAUNCH” beneath it; then “SATURDAY · 18 OCTOBER · 10:30 AM”; “PIER 7 · NORTH HARBOR”; “CHRISTENING · DECK TOUR · LIGHT LUNCH”; and “RSVP BY 4 OCTOBER” at the bottom. Keep every word correctly spelled, evenly aligned, and easy to read. No logos, no QR code, no envelope, no hands, no tabletop, no shadows, no photographic scene.",
  "width": 1024,
  "height": 1024
}
```

---

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

![Urban Beekeeper Personal Brand Portrait](https://assets.runware.ai/examples/recraft-v4-1-utility/9e133d6f-4131-4502-8c73-c6bd93690af7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "8c201f07-f20e-490b-9b7f-cdf94babaeab",
  "model": "recraft:v4.1-utility@0",
  "positivePrompt": "Commercial personal-branding photoshoot of a confident Black woman in her early 40s who runs an urban beekeeping consultancy, standing on a clean city rooftop apiary. Front-facing three-quarter portrait, subject centered and looking directly into the camera with a calm, capable expression. She wears a tailored saffron-yellow beekeeping jacket with the protective veil folded neatly behind her shoulders, dark indigo work trousers, and tan leather gloves tucked into one hand. Natural hair in a short sculpted twist style, understated gold stud earrings, realistic skin texture. Two simple matte-white beehive boxes sit behind her at different distances, with a softly defined brick skyline and pale overcast sky; restrained scene with generous negative space and no visual clutter. Diffused daylight with a subtle warm reflector, even flattering illumination, crisp facial detail, clean commercial photography, controlled depth of field, sophisticated palette of saffron, indigo, warm white, charcoal, and muted brick red. Strong geometric composition suitable for a founder profile, editorial feature, press kit, or social avatar. Photorealistic, polished, approachable, credible, contemporary. No text, logos, labels, watermark, extra people, or decorative border.",
  "width": 1024,
  "height": 1024
}
```

---

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

![Crop Insurance Social Campaign Visual](https://assets.runware.ai/examples/recraft-v4-1-utility/05b44b1a-a3c6-4316-9951-35f80c91036b.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "61a664db-e3a7-4bd2-9f89-c3c08eecaa92",
  "model": "recraft:v4.1-utility@0",
  "positivePrompt": "Polished square advertising campaign key visual for agricultural crop insurance. A single healthy sunflower with vivid golden petals and crisp green leaves grows from a neat circular patch of rich dark soil, centered in the lower half of the composition. The flower is protected beneath a transparent hemispherical shield rendered like clear glass, with a subtle warm golden rim. Outside the shield, a severe hailstorm strikes diagonally: sharp white hailstones and cold rain visibly bounce and deflect away from the dome. Inside, the sunflower remains dry, upright, warmly illuminated, and completely intact. Deep storm-navy background with controlled icy blue highlights, bright sunflower yellow as the focal accent, restrained premium palette. Front-facing symmetrical composition, simple scene, crisp silhouette, flatter commercial lighting, realistic materials, high-end photographic compositing, precise edges, subtle ground shadow, strong graphic-design appeal. Generous uncluttered negative space across the upper third for campaign copy placement. Image-only unbranded advertising artwork without typography, logos, labels, borders, interface elements, or watermark.",
  "width": 1024,
  "height": 1024
}
```