---
title: UNI-1 | Runware Docs
url: https://runware.ai/docs/models/luma-uni-1
description: Balanced unified image model for creation, precision editing, and multi-reference control
---
# UNI-1

![UNI-1](https://assets.runware.ai/covers/luma-uni-1.jpg)

UNI-1 is a unified image model in Luma's UNI-1 family for both image creation and precision image editing. It combines text prompting, source-image modification, multi-reference guidance, seed-based reproducibility, and reasoning-informed visual generation in one system, with strong control over composition, identity, style, and visual plausibility.

- **Status**: live
- **ID**: `luma:uni@1`
- Try in Playground
- **Creator**: Luma
- **Release Date**: May 5, 2026
- **Capabilities**: Text to Image, Image to Image, Checkpoint

## Pricing

$0.0404 per run · ~1m 47s per request

**Rates**

- 2K · per run: `$0.0404`
- Input image · per input image: `$0.003`

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/luma-uni-1/examples#example-big-bud-tractor-landscape-composite) · 1440p: `$0.0404` (~1m 59s)
- [text-to-image](https://runware.ai/docs/models/luma-uni-1/examples#example-shinkansen-ekiben-menu-hero) · 1440p: `$0.0404` (~2m 6s)
- [image-to-image](https://runware.ai/docs/models/luma-uni-1/examples#example-avalanche-field-recording-album-cover) · 2464×1696: `$0.0464` (~1m 35s)
- [reference-to-image](https://runware.ai/docs/models/luma-uni-1/examples#example-azores-geothermal-hiking-campaign-illustration) · 1504×2784: `$0.0464` (~1m 24s)

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

## Compatibility & Validation

When `inputs.seedImage` is provided, `settings.style` cannot be used.

---

When `inputs.seedImage` is provided, `settings.search` cannot be used.

---

When `inputs.seedImage` is provided, `inputs.referenceImages` is limited to 8 items.

---

When `settings.style` is `manga`, dimensions are limited to `1696×2464`, `1504×2784`, `1440×2912` or `1248×3360`.

---

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

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `3K (~3:1)` | `3360x1248` |
| `3K (~2:1)` | `2912x1440` |
| `3K (~16:9)` | `2784x1504` |
| `3K (~3:2)` | `2464x1696` |
| `3K (1:1)` | `2048x2048` |
| `3K (~2:3)` | `1696x2464` |
| `3K (~9:16)` | `1504x2784` |
| `3K (~1:2)` | `1440x2912` |
| `3K (~1:3)` | `1248x3360` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

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

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

Identifier for the type of task being performed.

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

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

Image output type.

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

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

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

Content safety checking configuration for image generation.

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

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/luma-uni-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.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [seedImage](https://runware.ai/docs/models/luma-uni-1#request-inputs-seedimage)

- **Path**: `inputs.seedImage`
- **Type**: `string`

Image used as a starting point for the generation (UUID, URL, Data URI, or Base64).

**Learn more** (3 resources):

- [Image To Image: Seed Image The Foundation](https://runware.ai/docs/learn/image-to-image#seed-image-the-foundation) (learn)
- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)
- [Image Outpainting: Seed Image The Starting Point](https://runware.ai/docs/learn/image-outpainting#seed-image-the-starting-point) (learn)

### [referenceImages](https://runware.ai/docs/models/luma-uni-1#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `9`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

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

- **Type**: `string`
- **Required**: true
- **Value**: `luma:uni@1`

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/luma-uni-1#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `6000`

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/luma-uni-1#request-width)

- **Type**: `integer`
- **Required**: conditional — Required when settings.style is manga
- **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/luma-uni-1#request-height)

- **Type**: `integer`
- **Required**: conditional — Required when settings.style is manga
- **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.

### [search](https://runware.ai/docs/models/luma-uni-1#request-settings-search)

- **Path**: `settings.search`
- **Type**: `boolean`

When enabled, the model searches the web for visual references before generating. This improves accuracy for prompts that reference real-world subjects, landmarks, or products.

### [style](https://runware.ai/docs/models/luma-uni-1#request-settings-style)

- **Path**: `settings.style`
- **Type**: `string`
- **Default**: `auto`

Applies a style preset to the generation.

**Allowed values**:

- `auto` Model selects the best style for the prompt.
- `manga` Manga/anime aesthetic with ink outlines and screentone shading.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/luma-uni-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/luma-uni-1#request-advancedfeatures-watermark-text)

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

Watermark text.

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

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

Text color in hex format.

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

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

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/luma-uni-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/luma-uni-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/luma-uni-1#response-imageuuid)

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

![Big Bud Tractor Landscape Composite](https://assets.runware.ai/examples/luma-uni-1/4ce2b8f5-b905-477e-b1ec-4664f96d042c.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "46789d41-fdcd-475f-9ac0-f65c7d548ac8",
  "model": "luma:uni@1",
  "positivePrompt": "Create a finished, photorealistic background-replacement composite featuring the real Big Bud 16V-747 tractor, accurately reproducing its monumental proportions, articulated chassis, cream-white bodywork, red-orange trim, authentic BIG BUD 747 markings, exhaust stacks, cab glazing, and eight enormous dual tires. Show the complete tractor from a low three-quarter front angle on the right side of a wide landscape frame. Replace any trade-show, museum, or parking-lot surroundings with a sunlit late-summer wheat field near Havre, Montana, with distant Bear Paw Mountains, a pale cyan sky, dry straw-gold grasses, and subtle windblown dust. Match the warm directional sunlight across the tractor and landscape; add realistic tire contact, compressed vegetation, and a soft grounded shadow. Preserve crisp, natural cutout edges around the cab, mirrors, exhausts, steps, and tires with no haloing or color spill. Leave generous uncluttered landscape and sky on the left for museum campaign copy, but include no added headline, logo, border, interface, or watermark. Grounded heritage-documentary art direction, restrained cream, oxidized red, straw gold, and clear blue palette, exceptional mechanical detail, believable scale, premium commercial retouching.",
  "width": 2912,
  "height": 1440,
  "settings": {
    "search": true
  }
}
```

---

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

![Shinkansen Ekiben Menu Hero](https://assets.runware.ai/examples/luma-uni-1/dde28088-7977-43f9-85b0-277e7e9aaa21.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "dddc82a1-696c-4a44-a503-7a33045cf589",
  "model": "luma:uni@1",
  "positivePrompt": "Premium landscape menu photography inside an accurately rendered N700S Shinkansen carriage traveling past Mount Fuji. In the foreground, an open Japanese ekiben box is the unmistakable hero: glossy soy-glazed anago over rice, precise slices of tamagoyaki, lotus root, bamboo shoot, edamame, shiso, umeboshi and seasonal pickles, each compartment immaculate and appetizing, with a small ceramic cup of green tea beside it. Place the meal on the window tray table, photographed from the adjacent passenger seat at table height. Through the large window, show a geographically plausible, sharply recognizable snow-capped Mount Fuji above sunlit fields, with subtle lateral motion blur near the tracks. Accurate contemporary Japanese high-speed-train interior details, clean blue upholstery, restrained white surfaces and soft daylight. Crisp editorial food styling, realistic steam and glaze, natural textures, bright cool morning palette with warm amber food accents, generous ultra-wide environmental framing, shallow but sufficient depth of field so the meal is tack-sharp and Mount Fuji remains clearly legible. Sophisticated hospitality catalog quality, photorealistic, no people, no visible logos, no packaging text, no captions or typography.",
  "width": 2912,
  "height": 1440,
  "settings": {
    "search": true,
    "style": "auto"
  }
}
```

---

### reference-to-image (reference-to-image)

![Azores Geothermal Hiking Campaign Illustration](https://assets.runware.ai/examples/luma-uni-1/cd32e5ce-2744-44b0-b888-a9158385f1a4.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "98f19dfe-28e9-4889-8d59-1c826d759fb3",
  "model": "luma:uni@1",
  "positivePrompt": "Create a finished portrait-oriented manga tourism campaign illustration for hiking in Furnas on São Miguel Island, Azores. Use reference image 1 to preserve the traveler's recognizable face, dark wavy hair, and white temple streak; use reference image 2 to preserve her rust-orange rain shell, charcoal trousers, mustard boots, teal backpack, and silver bottle. Show her hiking toward the viewer along a safe raised timber boardwalk through the real geothermal landscape of Furnas, turning back with an inviting, exhilarated smile. Low ferns and glossy hydrangea leaves frame the foreground; pale mineral steam rises from fenced caldeiras behind her; green volcanic slopes, tiled village roofs, and a glimpse of Furnas Lake recede through the mist. Dynamic low viewpoint with one boot stepping into the lower foreground, sweeping boardwalk lines leading upward through the composition, protagonist occupying the lower-middle third, generous atmospheric depth above her. Sophisticated contemporary travel manga, clean expressive ink lines, selective screentone texture, richly colored cel shading, mineral-turquoise steam, sulfur yellow accents, deep fern green vegetation, rust-orange jacket, soft pearl-gray sky. Fresh post-rain atmosphere with luminous breaks of Atlantic sunlight, wet timber reflections, believable volcanic terrain and practical hiking details. Aspirational, invigorating, welcoming, premium destination-campaign finish. One coherent scene, no text, no logo, no border, no UI, no collage.",
  "width": 1504,
  "height": 2784,
  "settings": {
    "style": "manga"
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/5a9a61bd-19c0-4556-9d12-15304aa29f71.jpg",
      "https://assets.runware.ai/assets/inputs/f58e9c45-bbfc-40a3-b33a-ecfe438b89b8.jpg"
    ]
  }
}
```

---

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

![Avalanche Field Recording Album Cover](https://assets.runware.ai/examples/luma-uni-1/6e76969c-4a17-49e5-a2c2-a3ae92c59f9b.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ba89250c-57e0-4ff4-9459-946c26f7fe06",
  "model": "luma:uni@1",
  "positivePrompt": "Transform the seed photograph into finished landscape album artwork for an experimental electronic field-recording album. Retain the clearly recognizable structure and perspective of the original scene: the exact mountain ridgeline, steel avalanche-control tower on the right, diagonal snow fences across the central slope, and service road beginning at the lower-left corner. Reinterpret the photograph as a bold two-color screen print combining deep cobalt blue shadows, cold off-white snow, and sparse fluorescent safety-orange accents on the tower and route markers. Add subtle halftone grain, weather-map contour lines, calibration ticks, and utilitarian Swiss safety-manual graphics without obscuring the landscape. Integrate a small duotone profile portrait of the musician from the reference image into the lower-right snowfield, preserving her recognizable facial identity and short dark hair; make it feel deliberately printed into the artwork rather than pasted on. Set the exact album title “RIME SIGNALS” in large condensed uppercase lettering across the open sky at upper left, with the exact artist name “MARA VEIL” in much smaller uppercase type beneath it. Crisp editorial hierarchy, severe alpine atmosphere, tactile ink texture, restrained contemporary record-label design, no border, no mockup, no additional words, no logos, one finished cover image composed for a wide 2464x1696 frame.",
  "width": 2464,
  "height": 1696,
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/9c9e8718-384e-4493-b5e3-909c6fbfc404.jpg",
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/1bb9ca8f-0b65-46aa-bc4b-69ac49f7e83b.jpg"
    ]
  }
}
```