# Wan 2.7

> Alibaba's Wan 2.7 image generation and editing model for text-to-image, reference-guided generation, and instruction-based image edits

## Quick Reference

- Model ID: wan-2.7
- Creator: Alibaba
- Status: active
- Family: wan
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Resolution: 2048x2048
- Max Output Images: 4
- Max Input Images: 9
- Input Modalities: text, image
- Output Modalities: image
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/wan-2.7?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Text prompt for image generation. Modes: Text to Image

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Modes: Text to Image, Image Edit
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Modes: Text to Image, Image Edit
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Modes: Text to Image, Image Edit

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Text to Image, Image Edit
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Text to Image, Image Edit
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Text to Image, Image Edit
- `n` (integer): Number of images to generate. Default: 1. Modes: Text to Image, Image Edit


## Model Identifiers

- Primary Slug: wan-2.7
- Aliases: wan2.7-image

## Dates

- Released: April 2026

## Tags

image-generation, text-to-image, image-editing, multi-image

## Available Providers

### Alibaba Cloud

- Config Key: alibaba/wan-2.7-image
- Provider Model ID: wan2.7-image
- Pricing: $0.030/image


## Performance Metrics

Provider performance over the last 30 days.

### alibaba

- Median Generation Time (p50): 6235ms
- 95th Percentile Generation Time (p95): 27056ms
- Average Generation Time: 10289ms
- Success Rate: 84.0%
- Total Requests: 50
- Time to First Byte (p50): 5702ms
- Time to First Byte (p95): 26632ms


## Image Gallery

4 images available for this model. Browse all at https://lumenfall.ai/models/alibaba/wan-2.7/gallery

### Curated Examples

- [A wide cinematic shot of a high-end, minimalist boutique storefront at dusk. The shop is built fr...](https://assets.lumenfall.ai/PgIgL4BtaODFfHs53Z2C6ep_2F6YmtDmx-39n4Sga6I/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/ca761u0klb89p3fwioh51inn98d3@jpeg)
- [A meticulous close-up of an elderly artisan's hands carving intricate floral patterns into a bloc...](https://assets.lumenfall.ai/bbY7fLq0dRZc__vfrpw3aj-fqA_Vwunq152XXM18uG4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/yxik75vh5j2pz4e4u06hddhhiux9@jpeg)
- [A meticulously detailed close-up of an elderly artisan's hands carving an intricate floral patter...](https://assets.lumenfall.ai/4Qy7dzRyr5IkBpj4ajENtLXE8SGAzu5c9-8UYCuJnvk/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/1u55zcrv2d01xcqshf5rxmgo2lsu@jpeg)
- [A sun-drenched artisan bakery storefront with an elegant gold-leaf sign on the window that reads ...](https://assets.lumenfall.ai/k7RiE8Mue0jmtpiLEdr7LPTpaTTAAMV4XncTLznQV8M/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/fddo9b0wmittkl2rbwju2elwepsx@jpeg)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A sun-drenched artisan bakery storefront with an elegant gold-leaf sign on the window that reads "FLOUR & BLOOM" in flowing luxury calligraphy. A small, calm capybara sits quietly on the sidewalk next to a basket of baguettes. 1:1, cinematic.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan-2.7",
    "prompt": "",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'wan-2.7',
  prompt: '',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="wan-2.7",
    prompt="",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Edit (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=wan-2.7" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'wan-2.7',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="wan-2.7",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## Frequently Asked Questions

### How much does Wan 2.7 cost?

Wan 2.7 starts at $0.03 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Wan 2.7 via API?

You can use Wan 2.7 through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "wan-2.7". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Wan 2.7?

Wan 2.7 is available through Alibaba Cloud on Lumenfall. Lumenfall automatically routes requests to the best available provider.

### What is the maximum resolution for Wan 2.7?

Wan 2.7 supports images up to 2048x2048 resolution.

## Links

- Model Page: https://lumenfall.ai/models/alibaba/wan-2.7
- About: https://lumenfall.ai/models/alibaba/wan-2.7/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/alibaba/wan-2.7/providers
- API Reference: https://lumenfall.ai/models/alibaba/wan-2.7/api
- Benchmarks: https://lumenfall.ai/models/alibaba/wan-2.7/benchmarks
- Use Cases: https://lumenfall.ai/models/alibaba/wan-2.7/use-cases
- Gallery: https://lumenfall.ai/models/alibaba/wan-2.7/gallery
- Playground: https://lumenfall.ai/playground?model=wan-2.7
- API Documentation: https://docs.lumenfall.ai