Wan 2.7 API

Introduction

Wan 2.7 Text to image turns a written art direction into a new image. Use it when composition, subject, lighting, and visual hierarchy need to be designed from a brief.

Choose a Wan 2.7 mode by starting material

Key features

The 9-image edit draws what you wrote

Give image-to-image a reference and it draws the brief you sent, wardrobe and framing included. On text-to-image it answers a restricted prompt with a more conservative frame instead. The cafe scene for this endpoint is text-to-image, an oversized white shirt with rain on the window, and that is roughly where the text endpoint stops.

Combine up to nine images without painting a mask

Image-to-image takes one to nine source images in a single request, so a garment, a face, a room and a colour reference can all enter the same edit. Say what each source is for in the prompt — an unlabelled stack gets averaged, which is the most common reason a nine-image edit comes back muddy.

It plans the layout before it draws

Wan 2.7 plans the frame before it draws it, which shows up in things that need a spatial decision: who is in the foreground, what the hand is holding, where the light source sits. Long descriptive prompts with a clear subject and one clear relationship beat keyword piles here.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 5 credits per image ($0.05).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Explore a visual concept before production

Text-to-image is the endpoint for a frame with nothing fixed yet: no face, garment or room that has to survive.

Create a storyboard key image

Generate the still at 3:2 or 9:16, then hand it to an image-to-video endpoint as the opening frame. The video prompt then only has to carry motion, which is the most literal way to get an exact wardrobe and pose into a clip.

Establish a campaign visual system

Hold one seed and one prompt skeleton, then sweep aspect_ratio across 1:1, 3:2 and 9:16 for a profile, a banner and a story card. The pixel budget is the same for every ratio, so a wider frame is wider, not larger.

Prompt guide & pro tips

Write composition before decoration

Name the subject, what they are doing and where the camera sits before light, materials and style. Wan 2.7 plans the frame before drawing it, so one clear spatial relationship beats a pile of adjectives.

Fix the seed, then change one thing

Once a frame is close, hold seed and vary a single clause: the wardrobe, the light, the ratio. The same seed keeps the draw steady, so any difference you see is the clause you changed; it does not guarantee an identical image.

Check the canvas before reusing the image

At the 1k default the canvas is about 1.01 to 1.05 megapixels whichever ratio you pick, and resolution: 2k gives about four times that. Text alone invents a new face on each seed, so when someone has to stay recognisable, move to image-to-image with a reference. Turning enable_thinking off is noticeably faster.

API quick start

Call the Wan 2.7 API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model alibaba/wan-2.7/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-2.7/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "aspect_ratio": "1:1",
    "num_outputs": 1,
    "resolution": "1k"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Wan 2.7 API questions

All Wan models

Wan 2.7 Pro adds a 4K canvas for text to image and 2K edits that hold longer instructions.

• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Wan 3.0 Prime APIQuicker Wan 3.0 renders, up to 30 seconds with audioFrom 46 credits for a 5-second clip
• Wan 3.0 Pro Prime APIQuicker Wan 3.0 Pro with 2K and 4K outputFrom 176 credits for a 5-second clip
• Wan 3.0 Pro APIWan 3.0 at 1080p, 2K or 4K, up to 30 secondsFrom 108 credits for a 5-second clip
• Wan 2.7 Pro APILarge 4K canvases and nine-image compositesFrom 12 credits per image
• Wan 2.7 APIThinks through the composition, then draws up to four imagesFrom 5 credits per image
• Wan 2.6 Flash APIQuick multi-shot clips from a single imageFrom 17 credits for a 5-second clip
• Wan 2.6 APIMulti-shot sequences with sound at up to 1080pFrom 49 credits for a 5-second clip
• Wan 2.5 API1080p clips with sound that can follow your own audioFrom 34 credits for a 5-second clip
• Wan 2.2 Animate APIDrive a character photo with a reference videoFrom 7.95 credits per second
• Wan 2.2 LoRA APIWan 2.2 video with your LoRAs on either expert passFrom 18 credits for a 5-second clip
• Wan 2.2 APISimple five-second clips at 480p or 720pFrom 36 credits per run
• Wan 2.2 5B LoRA APILight 720p Wan 2.2 clips that load your own LoRAsFrom 18 credits per run
• Wan 2.2 Image LoRA APIWan 2.2 stills with up to nine LoRAs across three slotsFrom 5 credits per image
• Wan 2.1 LoRA APIWan 2.1 video and edits with your own LoRAs, camera moves includedFrom 36 credits per run
• Wan 2.1 Image LoRA APIPhotoreal Wan 2.1 stills and restyles with your LoRAsFrom 5 credits per image

Other image APIs

• Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
• Nano Banana 2.1 APIGoogle's newest Nano Banana, sharp text and 4K outputFrom 8 credits per image
• Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image
• Nano Banana Pro APIPlans the layout first: dense text, diagrams and 4K editsFrom 17 credits per image
• GPT Image 2.5 Sunburst APIOpenAI's quality-first model, up to 4K with clean textFrom 1 credit per image
• Seedream 5.0 Pro APIHigh-detail images and edits from up to ten referencesFrom 6 credits per image

More about Wan 2.7

Try it

Wan 2.7 AI Image Generator onlineCreate images with Wan 2.7 in PopNow

Docs

Wan 2.7 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Wan 2.7 results without polling