---
title: Vidu Q1 | Runware Docs
url: https://runware.ai/docs/models/vidu-q1-image
description: High-fidelity multi-reference image synthesis
---
# Vidu Q1

![Vidu Q1](https://assets.runware.ai/covers/vidu-q1-image.jpg)

Vidu Q1 (image) is a reference-to-image model designed for high visual fidelity. It blends multiple input images with consistent identity and style. Prompts can guide composition and layout without losing coherence. The model supports flexible aspect ratios for ads, social content, storyboards or animation assets. It produces clean visuals with minimal effort and is useful for rapid creative workflows.

- **Status**: live
- **ID**: `vidu:q1@image`
- Try in Playground
- **Creator**: Vidu
- **Release Date**: March 29, 2025
- **Capabilities**: Image to Image, Checkpoint

## Pricing

$0.055 per run · ~39s per request

**Rates** (per run)

- 1080p: `$0.055`

**4 example generations**

- [reference-to-image](https://runware.ai/docs/models/vidu-q1-image/examples#example-subterranean-survey-crew-portrait): `$0.055` (~40s)
- [reference-to-image](https://runware.ai/docs/models/vidu-q1-image/examples#example-master-horologist-press-headshot): `$0.055` (~35s)
- [reference-to-image](https://runware.ai/docs/models/vidu-q1-image/examples#example-estonian-bog-sauna-tourism-campaign): `$0.055` (~38s)
- [reference-to-image](https://runware.ai/docs/models/vidu-q1-image/examples#example-tidal-forager-workwear-lookbook): `$0.055` (~47s)

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 |
| --- | --- |
| `1080p (16:9)` | `1920x1080` |
| `1080p (1:1)` | `1440x1440` |
| `1080p (9:16)` | `1080x1920` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/vidu-q1-image#request-tasktype)

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

Identifier for the type of task being performed.

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

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

Image output type.

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

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

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

Content safety checking configuration for image generation.

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

- **Type**: `boolean`

Include task cost in the response.

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

### [referenceImages](https://runware.ai/docs/models/vidu-q1-image#request-inputs-referenceimages)

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

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/vidu-q1-image#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `vidu:q1@image`

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/vidu-q1-image#request-positiveprompt)

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

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/vidu-q1-image#request-width)

- **Type**: `integer`
- **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/vidu-q1-image#request-height)

- **Type**: `integer`
- **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)

**Features**

Standalone addons and post-processing features.

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

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

Watermark text.

#### [image](https://runware.ai/docs/models/vidu-q1-image#request-advancedfeatures-watermark-image)

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

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

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

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

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/vidu-q1-image#request-advancedfeatures-watermark-bgcolor)

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

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/vidu-q1-image#response-tasktype)

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

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/vidu-q1-image#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/vidu-q1-image#response-imageuuid)

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

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/vidu-q1-image#response-imageurl)

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

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/vidu-q1-image#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/vidu-q1-image#response-imagedatauri)

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

Data URI of the output image.

### [NSFWContent](https://runware.ai/docs/models/vidu-q1-image#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/vidu-q1-image#response-cost)

- **Type**: `float`

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

## Examples

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

![Subterranean Survey Crew Portrait](https://assets.runware.ai/examples/vidu-q1-image/2bc52299-fe33-4f29-a5a4-ee6c4402a110.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "54d2b57e-4167-4515-8426-8361433e316f",
  "model": "vidu:q1@image",
  "positivePrompt": "Create one finished square annual-report photograph that integrates the woman from reference image 2 into the utility-tunnel crew from reference image 1. Preserve the recognizable faces, ages and practical workwear of all six original crew members, and preserve the woman’s identity, clear safety glasses, white hard hat, orange vest and rolled plan. The final image must show exactly seven people, with the lead engineer standing naturally in the central opening among her colleagues, matching their scale, perspective, posture, light direction, damp clothing texture and muddy footing. Arrange the crew as a credible close-knit inspection team, shoulders slightly overlapping, with relaxed expressions after a night shift. Retain the monumental wet concrete tunnel, shallow reflective water, surveying tripod and receding pipes. Cinematic but truthful infrastructure documentary photography: cool cyan work lights balanced by warm amber utility lamps, restrained slate-gray, navy and safety-orange palette, crisp faces, subtle grain, deep environmental detail, eye-level wide-angle composition. No captions, branding, duplicate people or artificial cutout edges.",
  "width": 1440,
  "height": 1440,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/2c175a1f-2c24-460c-af15-f313728bd4e4.jpg",
      "https://assets.runware.ai/assets/inputs/afa43252-2958-48f5-a746-6ba450104b49.jpg"
    ]
  }
}
```

---

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

![Master Horologist Press Headshot](https://assets.runware.ai/examples/vidu-q1-image/90e470c5-24e4-4bc2-b6b8-b66f22b4d809.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "1df15755-35ff-4c0b-ac6f-c0bde3e58692",
  "model": "vidu:q1@image",
  "positivePrompt": "Create a finished square press-kit headshot for a master horologist, synthesizing both references into one coherent portrait. Preserve the exact identity, age, facial proportions, cropped silver hair, glasses, and authentic features of reference image 1. Place her chest-up at her watchmaker's bench, wearing the same navy chore coat over a simple charcoal shirt. Translate the aged brass, dark walnut, oxblood leather, graphite-blue shadows, and warm task-lamp glow of reference image 2 into the setting and lighting. Calm direct eye contact and a quietly authoritative expression; shoulders angled slightly while her face turns toward camera. Professional editorial retouching only: even color, soften temporary blemishes and under-eye fatigue, tame flyaways, clean eyeglass reflections, and add subtle eye clarity while retaining pores, fine lines, natural skin variation, and every permanent feature. Warm key light from camera left, cool soft fill, delicate rim light on silver hair. Background bench details recognizable but softly defocused. Premium medium-format realism, 85mm portrait perspective, crisp eyes, natural tonal range, restrained contrast. Balanced square composition with comfortable headroom. No text, logos, excessive smoothing, facial reshaping, glamour makeup, duplicated tools, or distorted glasses.",
  "width": 1440,
  "height": 1440,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/1654f74e-24e0-4276-9e5b-88e66aed7c61.jpg",
      "https://assets.runware.ai/assets/inputs/2184fbc2-c443-467d-b684-501be6ad4d38.jpg"
    ]
  }
}
```

---

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

![Estonian Bog Sauna Tourism Campaign](https://assets.runware.ai/examples/vidu-q1-image/71cd77ef-f494-44ab-b572-4f7f71fe850c.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "e1cc23b6-b34b-48b7-858e-7ca910d454e3",
  "model": "vidu:q1@image",
  "positivePrompt": "Create a finished square tourism campaign image that synthesizes the Estonian raised-bog landscape and boardwalk from reference 1 with the authentic charred-log smoke-sauna architecture from reference 2. A lone adult traveler in practical moss-green outdoor clothing walks away from camera along the curving timber boardwalk toward the small sauna, which sits naturally on a firm island among amber sedges and dark reflective pools. Early autumn dawn, low silver mist, cool celadon and peat-brown landscape, one warm amber window as the visual destination. Wide environmental composition with the traveler small for scale; boardwalk creates a strong leading line from the lower foreground to the sauna near the upper-right third. Premium documentary travel photography, quiet restorative mood, realistic wet timber and vegetation, subtle atmospheric depth, soft diffused light, natural color, crisp editorial finish. Preserve believable Estonian ecology and the sauna's handmade construction. No fantasy elements, no excessive luxury styling, no text, logo, border, collage, or mockup.",
  "width": 1440,
  "height": 1440,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/f3f0b9d3-97da-45bf-b684-064b8c43f7b3.jpg",
      "https://assets.runware.ai/assets/inputs/90a76113-e4d7-47cc-89d7-9b1ae4910363.jpg"
    ]
  }
}
```

---

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

![Tidal Forager Workwear Lookbook](https://assets.runware.ai/examples/vidu-q1-image/ff34f2a8-0e38-4996-9781-236372f8a8b4.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "d7c95d05-9feb-4326-9be0-d3f5878a2e6c",
  "model": "vidu:q1@image",
  "positivePrompt": "Create a finished square fashion lookbook photograph for a premium coastal-foraging workwear collection. Synthesize the exact garment design, materials and restrained lichen-green, rust, charcoal and cream palette from reference image 1 with the authentic shellfish sorting shed, cool maritime light and weathered utilitarian design language of reference image 2. Show the same model full length in a new natural pose beside a galvanized sorting table, one hand lightly holding an empty oyster basket, looking just past camera with quiet confidence. Preserve clear visibility of the waxed-canvas jacket silhouette, oversized pockets, merino collar, waterproof bib construction and deck boots. Ground the outfit naturally in the wet working environment without making the clothing dirty. Eye-level medium-format editorial photography, subtle frontal fill, cool overcast doorway light, crisp textile detail, realistic skin, gentle reflections on damp concrete, restrained documentary mood. Balanced square composition with breathing room, catalog-ready polish, no text, no logos, no border, no collage, no duplicated garments or people.",
  "width": 1440,
  "height": 1440,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/62a3c772-dd66-469a-b607-892cf4cafc81.jpg",
      "https://assets.runware.ai/assets/inputs/8273f37d-12cf-4594-ae3f-0e4ebddffaec.jpg"
    ]
  }
}
```