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/video-edit",
  "input": {
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "video_url": "https://example.com/video.mp4",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 0
  }
}
'

{
  "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>"
}

​

Wan 2.7 Video Edit

Rework existing footage with Wan 2.7 using text and an optional reference image to guide changes to the scene.

​

Available Models

• alibaba/wan-2.7/video-edit - Edit an existing video using written instructions.

​

Duration Options

• Automatic - duration: 0 is the default. The service detects the source-video duration, checks that it is 2-10 seconds, then rounds down to whole seconds. The same whole-second duration is used for billing and upstream generation.
• Explicit output length - Set duration to 2, 3, 4, 5, 6, 7, 8, 9, 10 seconds.
• With duration: 0, the source must be a publicly reachable HTTP(S) file no larger than 100 MiB.

​

Key Features

• Edit an existing video using written instructions.
• Choose from 720p, 1080p output resolutions.

​

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. Image inputs also accept image Data URIs or raw Base64. Image conversion and media validation complete before credits are deducted. duration and seed also accept integer strings such as "5"; decimal numbers such as 5.0 and decimal strings such as "5.0" are rejected. Null or empty values use the default duration or omit the seed. Supported boolean fields also accept 0/1 and case-insensitive strings true/false, 1/0, yes/no, y/n, and on/off; null omits the field. Surrounding whitespace is trimmed, and resolution values are case-insensitive.

​

Prompt

• prompt: Required. Describe the requested changes. Maximum: 5,000 Unicode characters.
• Leading and trailing whitespace is trimmed. A nonblank prompt is required.

​

Reference Image URL

• reference_image_url: Optional. Provide an image to guide the edit as a public HTTP(S) URL, image Data URI, or raw Base64.

​

Source Video

• video_url: Required. Provide the source video URL. Use a publicly accessible HTTP(S) URL.

​

Aspect Ratio

• aspect_ratio: Optional. Accepted values: 16:9, 9:16, 1:1, 4:3, 3:4. Default: 16:9.

​

Resolution

• resolution: Optional. Accepted values: 720p, 1080p. Default: 720p.

​

Multi-Shot Generation

• multi_shots: Optional. Enable multi-shot generation. Use true or false.

​

Audio Settings

• audio_setting: Optional. Supply the audio setting as a string.

​

Seed

• seed: Optional. Set the generation seed. Integer from 0 to 2147483647.

​

Safety Checker

• enable_safety_checker: Optional. Control safety checking. Use true or false.

​

Pricing

Usage equals output seconds multiplied by the selected resolution rate. See Pricing for current rates. Credits are deducted on submission and refunded if the task fails.