Skip to main content
POST
  1. After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
  2. Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
Rework images with text instructions and up to four visual references, exploring new compositions and variations with Wan 2.7.

Models

  • alibaba/wan-2.7/image-edit - Edit images using a prompt and image references.

Features

  • Edit images using a prompt and image references.
  • Accepts 1-4 images in image_urls.
  • Control the number of output images with n.

Output Options

Image Size

  • size: Optional. Default: 1024x1024.
  • Presets: 512x512, 1024x1024, 768x1024, 1024x768, 576x1024, 1024x576.
  • For custom dimensions, supply an object with integer width and height; both must be positive.

Image Count

  • n: Optional. Number of images to generate. Integer from 1 to 4. Default: 1.

Advanced Parameters

Set model and optional callback_url at the request root. Place all workflow parameters, including output options, inside input. Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.

Prompt

  • prompt: Required. Describe the requested changes. Length: 1-5,000 characters.
  • The value must not be blank when supplied.

Image URLs

  • image_urls: Required. Provide publicly accessible image URLs. Supply 1-4 items. Each item must be an HTTP(S) URL. Order matters: refer to them as image 1, image 2, image 3, image 4 in the prompt. A single string or Base64 image is not accepted.

Seed

  • seed: Optional. Set the generation seed. Integer.

Billing Factors

Billing depends on the selected model variant and output image count (n). Output size does not add a charge. Reference images do not add a surcharge. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

Use VIDGO_API_KEY.

Body

application/json

Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.

model
string
required
Example:

"alibaba/wan-2.7/image-edit"

input
object
required

Input parameters for this public endpoint. Use an image-edit endpoint when supplying reference images.

callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required