Wan2.7 Image API

Image generation and editing companion model: text-to-image, bounding-box edits, and cohesive image sets, with up to 4K output on Pro.

Alibaba CloudImage GenerationSingaporeProprietary Endpoint

About Wan2.7 Image

Image generation and editing companion model: text-to-image, bounding-box edits, and cohesive image sets, with up to 4K output on Pro.

image editing4k

Wan2.7 Image specs

Model ID
wan2-7-image
Provider
Alibaba Cloud
Category
Image Generation
Input
text, image
Output
image
Region
Singapore
Endpoints
POST /v1/images/generations

Wan2.7 Image API pricing

Live pay-as-you-go rates from the EmpirioLabs catalog. You are billed only for what you use, with no monthly minimum.

Type
Spec
Rate
Standard
per image
$0.030
Pro
per image
$0.075
Compare on the full pricing page

How to call the Wan2.7 Image API

Wan2.7 Image runs through POST /v1/images/generations. The request returns a job_id right away; poll GET /v1/jobs/{job_id} until the job completes and read the output URLs from the result. Or add "sync": true to skip polling: the request stays open and returns the finished OpenAI-style image response directly, so OpenAI SDKs work as-is. Get an API key from the EmpirioLabs dashboard.

cURL: submit the job
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2-7-image",
    "prompt": "Describe what you want Wan2.7 Image to generate."
  }'
cURL: poll for the result
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "wan2-7-image",
        "prompt": "Describe what you want Wan2.7 Image to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)
Full Wan2.7 Image API reference

Wan2.7 Image API parameters

Request parameters supported by the Wan2.7 Image API on EmpirioLabs. Defaults apply when a field is omitted.

ParameterTypeDefaultRange / valuesDescription
promptstring--Text prompt. For Image Set mode, describe each image in sequence (e.g. 'First image: ... Second image: ...').
model_variantenumwan2.7-image-prowan2.7-image-pro, wan2.7-imagePro: 4K + Thinking Mode + higher quality. Standard: faster, cheaper.
aspect_ratioenum-16:9, 1:1, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5Optional. If omitted, text-to-image defaults to 16:9; image-edit matches the last input image's native ratio.
resolutionenum2K1K, 2K, 4KQuality tier. 1K ~1MP, 2K ~4MP, 4K ~16MP (Pro text-to-image only).
use_custom_sizebooleanfalse-Override aspect_ratio + resolution with explicit pixel dimensions.
custom_widthnumber-768 to 4096Pixels (768–2048; Pro text-to-image up to 4096). Only when use_custom_size=true. Aspect must be in [1:8, 8:1].
custom_heightnumber-768 to 4096Pixels (768–2048; Pro text-to-image up to 4096). Only when use_custom_size=true.
enable_sequentialbooleanfalse-Image Set Mode. Generate up to 12 cohesive related images. Disables thinking_mode and color_palette.
num_imagesnumber11 to 4Standard mode only. Number of images to generate. Each is billed separately.
num_images_setnumber11 to 12Image Set Mode only. Maximum images in the set. The model decides the actual count; you're billed only for images generated.
thinking_modebooleantrue-Pro only. Enhanced inference for higher quality at the cost of latency. Auto-ignored when input images are attached or sequential mode is on.
imagearray--Up to 9 input image URLs for editing. Triggers image-edit mode automatically.
color_palettestring--Optional JSON array of 3–10 {hex, ratio} objects (ratios sum to 100%). Standard mode only. Example:...
bbox_liststring--Interactive editing boxes as JSON. Use [] for no box, or [[x1,y1,x2,y2]] for one box.
3 more parameters in the docs

Good to know

Upload 1-9 images for editing mode; without images, operates as text-to-image.

Constraints

  • Prompt max 5,000 characters
  • Generation: 10-60s depending on resolution, image count, model variant, and thinking mode

Image inputs (editing mode)

  • JPEG, PNG, BMP, or WEBP
  • 240-8000 px per side
  • Aspect ratio 1:8 to 8:1
  • Max 20 MB per image

Capabilities

  • Style transfer, object placement, scene blending, background replacement, multi-reference composition, interactive editing with bounding boxes
  • Pro variant supports up to 4K output

Wan2.7 Image API: common questions

How much does the Wan2.7 Image API cost?

On EmpirioLabs, Wan2.7 Image is billed pay as you go: Standard $0.030 per image; Pro $0.075 per image. The live rate card on this page always matches what the API charges.

Which endpoint does Wan2.7 Image use?

Wan2.7 Image is served through POST /v1/images/generations on api.empiriolabs.ai with standard bearer-token authentication.

Can I try Wan2.7 Image in the browser before integrating?

Yes. The EmpirioLabs playground runs Wan2.7 Image in the browser with the same parameters the API exposes, so you can test prompts before writing code.

How do I get a Wan2.7 Image API key?

Create an EmpirioLabs account, then generate a key under API Keys in the dashboard. Billing is pay-as-you-go credits, so you only pay for the requests you make.

Ready to use better endpoints?

Explore our models, or contact us about business inquiries, custom deployments, or anything else.