curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/wan-2.7/image-edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"size": "1024x1024",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Alibaba
Wan 2.7 Image Edit
Rework images with text instructions and up to four visual references, exploring new compositions and variations with Wan 2.7.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/wan-2.7/image-edit",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"prompt": "A quiet forest under soft morning light, with natural detail.",
"size": "1024x1024",
"n": 1
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Wan 2.7 Image Edit
Rework images with text instructions and up to four visual references, exploring new compositions and variations with Wan 2.7.Available Models
- alibaba/wan-2.7/image-edit - Edit images using a prompt and image references.
Output Options
Image Size
size: Optional. Default:1024x1024.- Presets:
512x512,1024x1024,768x1024,1024x768,576x1024,1024x576. - For custom dimensions, supply an object with integer
widthandheight; both must be positive.
Image Count
n: Optional. Number of images to generate. Integer from1to4. Default:1.
Key Features
- Edit images using a prompt and image references.
- Accepts 1-4 images in
image_urls. - Control the number of output images with
n.
Advanced Parameters
Setmodel 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
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.
Example:
"alibaba/wan-2.7/image-edit"
Input parameters for this public endpoint. Use an image-edit endpoint when supplying reference images.
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.