---
title: Wan2.7 Image | Runware Docs
url: https://runware.ai/docs/models/alibaba-wan2-7-image
description: Unified image generation and editing with avatar customization, color control, and multilingual text rendering
---
# Wan2.7 Image

![Wan2.7 Image](https://assets.runware.ai/covers/alibaba-wan2-7-image.jpg)

Wan2.7 Image is a unified image generation and editing model from Alibaba that combines generation and interactive editing in a shared latent space. It features virtual avatar face customization with fine bone structure and eye shape control, a color palette system for extracting and applying consistent color schemes, precise marquee selection editing for pixel-level element manipulation, multilingual text rendering supporting up to 3000 tokens in 12 languages, and compositional generation of up to 12 images in a single output.

- **Status**: live
- **ID**: `alibaba:wan@2.7-image`
- Try in Playground
- **Creator**: Alibaba
- **Release Date**: April 1, 2026
- **Capabilities**: Text to Image, Image to Image, Edit, Checkpoint

## Pricing

$0.03 per run · ~14s per request

**4 example generations**

- [sequential-images](https://runware.ai/docs/models/alibaba-wan2-7-image/examples#example-coastal-weather-archive-restoration) · 1080p: `$0.03` (~14s)
- [local-editing](https://runware.ai/docs/models/alibaba-wan2-7-image/examples#example-volcanologist-risograph-profile-avatar) · 1280×1280: `$0.03` (~13s)
- [text-to-image](https://runware.ai/docs/models/alibaba-wan2-7-image/examples#example-textile-water-recycling-campaign-visual) · 1536×1024: `$0.03` (~5s)
- [reference-to-image](https://runware.ai/docs/models/alibaba-wan2-7-image/examples#example-community-radio-pledge-drive-post) · 1024×1536: `$0.03` (~18s)

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

## Compatibility & Validation

When `settings.editRegions` is provided, `inputs.referenceImages` is required.

---

When `settings.sequential` is `true`, `settings.colorPalette` cannot be used.

---

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

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/alibaba-wan2-7-image#request-tasktype)

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

Identifier for the type of task being performed.

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

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

Image output type.

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

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

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

Content safety checking configuration for image generation.

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

- **Type**: `boolean`

Include task cost in the response.

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

- **Type**: `string`
- **Required**: true
- **Value**: `alibaba:wan@2.7-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/alibaba-wan2-7-image#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Max**: `3000`

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/alibaba-wan2-7-image#request-width)

- **Type**: `integer`
- **Required**: true
- **Min**: `768`
- **Max**: `2048`
- **Step**: `16`

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/alibaba-wan2-7-image#request-height)

- **Type**: `integer`
- **Required**: true
- **Min**: `768`
- **Max**: `2048`
- **Step**: `16`

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)

### [seed](https://runware.ai/docs/models/alibaba-wan2-7-image#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `2147483647`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Seed](https://runware.ai/docs/learn/seed) (learn)

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [colorPalette](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-colorpalette)

- **Path**: `settings.colorPalette`
- **Type**: `array of objects (2 properties)`
- **Min items**: `3`
- **Max items**: `10`

Color palette to guide the generation. Each entry specifies a hex color and its ratio.

#### [hex](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-colorpalette-hex)

- **Path**: `settings.colorPalette.hex`
- **Type**: `string`
- **Required**: true

Hex color code (e.g. '#C2D1E6').

#### [ratio](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-colorpalette-ratio)

- **Path**: `settings.colorPalette.ratio`
- **Type**: `string`
- **Required**: true

Percentage weight of this color in the palette (e.g. '23.51%').

### [editRegions](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-editregions)

- **Path**: `settings.editRegions`
- **Type**: `array of arrays`

Interactive editing regions. Must match the number of input images. Each entry is an array of bounding boxes in \[x1, y1, x2, y2\] format using absolute pixel coordinates. Use an empty array for images that don't need editing.

### [sequential](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-sequential)

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

Enables image set output mode for generating multiple related images.

### [thinking](https://runware.ai/docs/models/alibaba-wan2-7-image#request-settings-thinking)

- **Path**: `settings.thinking`
- **Type**: `boolean`
- **Default**: `true`

Enables thinking mode for improved quality at the cost of increased generation time.

**Features**

Standalone addons and post-processing features.

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

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

Watermark text.

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

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

Text color in hex format.

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

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

Background color in hex format.

## Response Parameters

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

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

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/alibaba-wan2-7-image#response-imageurl)

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

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/alibaba-wan2-7-image#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/alibaba-wan2-7-image#response-imagedatauri)

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

Data URI of the output image.

### [seed](https://runware.ai/docs/models/alibaba-wan2-7-image#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/alibaba-wan2-7-image#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

![Textile Water Recycling Campaign Visual](https://assets.runware.ai/examples/alibaba-wan2-7-image/29405b73-e833-4800-bd97-e59114859440.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "e455b894-339a-4c57-a12b-5365fdfad998",
  "model": "alibaba:wan@2.7-image",
  "positivePrompt": "Premium landscape advertising key art for an industrial water-recycling campaign, shown as a cinematic architectural cutaway of a contemporary textile dye house. On the left, broad ribbons of fabric in saturated vermilion and deep indigo sweep through stainless-steel dyeing machinery; colored wastewater travels through transparent pipes into a sculptural central filtration system with stacked circular membranes, glass tanks and precise valves. Across the image, the liquid visibly transforms from dark dye into luminous clear aqua water, then loops back toward the production line on the right, making the closed-loop process instantly understandable. A female textile engineer in cream workwear stands beside the filtration unit for human scale, inspecting a tablet without dominating the composition. Art direction: sophisticated photorealistic CGI blended with crisp editorial infographics, immaculate industrial design, tactile fabric weave, condensation on glass, brushed metal, subtle steam, realistic reflections. Deliberate restricted palette: deep indigo as the dominant factory environment, warm cream architecture, vermilion fabric accents, bright aqua recycled water, and charcoal machinery. Strong lateral flow from left to right, rhythmic pipework and fabric curves, generous uncluttered cream wall area in the upper right for campaign copy, wide 3:2 composition, polished global sustainability advertising aesthetic, optimistic and technically credible, soft directional skylight with focused highlights, no logos, no labels, no typography, no UI, finished standalone campaign image.",
  "width": 1536,
  "height": 1024,
  "settings": {
    "colorPalette": [
      {
        "hex": "#17324D",
        "ratio": "50%"
      },
      {
        "hex": "#D9A441",
        "ratio": "30%"
      },
      {
        "hex": "#F2E8D5",
        "ratio": "20%"
      }
    ]
  }
}
```

---

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

![Community Radio Pledge Drive Post](https://assets.runware.ai/examples/alibaba-wan2-7-image/22c8a19a-c7f8-4fb5-897c-8142e4699300.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "d365ed71-a4bd-4be8-a67a-a71bc5b50a2d",
  "model": "alibaba:wan@2.7-image",
  "positivePrompt": "Create a finished vertical social media campaign graphic for a nonprofit community radio pledge week. Meaningfully combine the references into a new composition: use the first image only to preserve the believable construction cues of an analog portable radio—cream molded case, metal speaker grille, red tuning window, tactile knobs and antenna—while changing its viewpoint and presentation; use the second image for the tactile cut-paper materials, cobalt, tomato, mint, cream and charcoal palette, rhythmic arcs, frequency bars, rough edges and cast shadows. Do not reproduce either reference as-is.\n\nBuild a bold editorial still life in which the radio sits in the lower third at a dramatic low three-quarter angle, partly constructed from layered paper and partly photoreal, while concentric broadcast waves expand upward into a structured collage. Let the antenna create a strong diagonal through the layout. Add a few small paper stars and waveform fragments, but keep the design disciplined and civic rather than nostalgic kitsch. Warm directional studio light, convincing dimensional shadows, subtle paper fibers, crisp subject edges, high contrast, optimistic grassroots energy.\n\nReserve the upper half for exact, highly legible typography integrated into the collage. Set the headline on four lines: “KEEP / LOCAL / SIGNALS / STRONG”. Use condensed uppercase sans-serif lettering in cream and cobalt, with “SIGNALS” in tomato red. Beneath it, include “PLEDGE WEEK” and “OCT 12–18, 2026”. At the bottom, add the small line “LISTENER-POWERED COMMUNITY RADIO”. Strong typographic hierarchy, generous margins, balanced negative space, accessible contrast. One polished standalone social post, not a phone screen, app interface, webpage, billboard mockup or framed poster. No logos, station names, extra copy, buttons, watermarks or misspelled text.",
  "width": 1024,
  "height": 1536,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/33f81ab1-f91d-41e5-9856-72b8c88f2093.jpg",
      "https://assets.runware.ai/assets/inputs/603a40bb-bf77-4e36-b9dd-47b1c6cb2ed0.jpg"
    ]
  }
}
```

---

### sequential-images (sequential-images)

![Coastal Weather Archive Restoration](https://assets.runware.ai/examples/alibaba-wan2-7-image/0477bd55-7452-4874-90f9-be5945021a33.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "8c0a0d97-5ec8-4f8e-a8cc-937617e78198",
  "model": "alibaba:wan@2.7-image",
  "positivePrompt": "Create a coherent four-image archival photo-restoration sequence based on the same exact 1957 documentary photograph. The scene shows a woman meteorological technician launching a large white radiosonde balloon outside a remote Norwegian coastal weather station, with two colleagues assisting beside a white clapboard instrument hut, a narrow radio mast, rocky shoreline and cold North Sea beneath an overcast sky. Preserve identical people, facial features, clothing, hand positions, balloon shape, architecture, camera angle and framing throughout the set. Authentic mid-century medium-format documentary photography, natural expressions, practical wool coats, rubber boots and simple scientific equipment.\n\nImage 1: untreated archive scan, faded warm monochrome, low contrast, dust, fine scratches, silver mirroring, foxing, a pronounced diagonal fold, torn lower-right corner and several small areas of emulsion loss, while the underlying scene remains legible.\n\nImage 2: careful structural repair, tears and missing corner seamlessly reconstructed, fold and scratches removed, dust cleaned, balanced neutral black-and-white tones, original grain and period lens character preserved.\n\nImage 3: conservative historically researched colorization of the repaired photograph: slate-blue sea, pale gray sky, weathered white station, muted navy and brown wool clothing, dull red instrument case, natural restrained skin tones; no modern saturation.\n\nImage 4: final exhibition master, the same accurate colorization with refined tonal separation, subtle local contrast and crisp printable detail, still visibly an authentic 1950s photograph rather than a modern digital photo. Full-frame landscape compositions, no captions, labels, borders, interface elements or decorative collage treatment.",
  "width": 1920,
  "height": 1088,
  "settings": {
    "sequential": true
  }
}
```

---

### local-editing (local-editing)

![Volcanologist Risograph Profile Avatar](https://assets.runware.ai/examples/alibaba-wan2-7-image/d3380f48-c527-4b27-a213-b079faf5eba7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "6478da51-3545-42a2-8fc6-d0c236efbf35",
  "model": "alibaba:wan@2.7-image",
  "positivePrompt": "Edit only the person inside the selected marquee region, turning her into a bold handcrafted risograph profile avatar while preserving her recognizable facial identity, short curly hairstyle, direct gaze, pose and silhouette. Render her face and field jacket with crisp graphic shapes, visible halftone dots, slightly imperfect ink registration and layered cobalt blue, fluorescent safety yellow, warm coral and charcoal inks. Add subtle contour-line motifs across the jacket and a small seismograph-wave accent near the collar, without logos or lettering. Keep the treatment polished, authoritative and suitable for a volcano observatory scientist’s professional profile image. Preserve every part of the monitoring room outside the selected region exactly as photographed, including its lighting, maps, displays, equipment, focus and composition. Do not stylize, replace, repaint or alter the surrounding scene. One central subject, square composition, no additional people, no text, no border.",
  "width": 1280,
  "height": 1280,
  "settings": {
    "editRegions": [
      [
        [
          320,
          160,
          704,
          800
        ]
      ]
    ]
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/b017eece-1450-4d42-bddb-60243aaf1757.jpg"
    ]
  }
}
```