Model API

WAN 2.7 Image

Transform and edit existing images with text-guided instructions using the WAN 2.7 model for creative image manipulation.

Model id

Use this in every request
wan/v2.7/edit

This model has other modes with their own ids: wan/v2.7/text-to-image.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/v2.7/edit",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_urls": [
      "https://example.com/input.png"
    ]
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "wan/v2.7/edit", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_urls":["https://example.com/input.png"]}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for wan/v2.7/edit
NameTypeDescription
promptrequiredstring
Text prompt describing the desired image edit. Supports Chinese and English.
image_urlsrequiredarray of image URLs
Reference images for editing (1-4 images required). Order matters: reference them as image 1, image 2, image 3, image 4 in the prompt.
negative_promptstring
Content to avoid in the generated image. Max 500 characters.
image_sizestring (enum)
Output image size. Uses image size presets or explicit dimensions and is converted to DashScope size format.

Default: square_hd

One of: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9

num_imagesinteger
Number of images to generate (1-4).

Default: 1

enable_prompt_expansionboolean
Enable DashScope prompt expansion. Supported only for image edit mode.

Default: true

seedinteger
Random seed for reproducibility (0-2147483647).
output_formatstring (enum)
The format of the generated images.

Default: jpeg

One of: jpeg, png, webp

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

  • 1 image$0.05/ image

The exact charge for your input comes from a quote. How charges settle