Browse ModelsAlibabaAlibaba Wan 2.7 Video Edit

Alibaba Wan 2.7 Video Edit

Alibaba Wan 2.7 Video Edit

Playground

Try it on WavespeedAI!

Alibaba WAN 2.7 Video Edit performs prompt-driven video editing with multi-image reference support, supporting 720p/1080p output. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Wan 2.7 Video Edit

Wan 2.7 Video Edit performs prompt-driven editing on existing videos with optional multi-image reference support. Upload a source video, describe the desired edits in natural language, and optionally provide reference images to guide the target style or element appearance — the model applies precise, context-aware edits while preserving motion and temporal consistency throughout the clip.


Why Choose This?

  • Natural-language video editing Describe your edit in plain text — swap colors, change objects, alter styles — without manual masking or keyframing.

  • Multi-image reference support Upload 1 to 9 reference images to guide the target element, style, or appearance in the edited output.

  • Audio control Choose between auto mode (model decides) or origin to preserve the original audio track.

  • Negative prompt support Specify what to avoid in the edit for more precise control over the output.

  • Prompt expansion Enable enable_prompt_expansion to let the model automatically enrich and optimize your prompt before generation.

  • Resolution options Generate at 720p or 1080p to match your delivery requirements.


Parameters

ParameterRequiredDescription
videoYesSource video to edit (URL or file upload).
promptYesText description of the desired edits.
imagesNoReference images to guide editing (1–9 images). Click Add Item for more.
negative_promptNoElements to exclude from the edited video.
resolutionNoOutput resolution: 720p (default) or 1080p.
durationNoOutput duration in seconds. Default 0 = same as input video. Set 2–10 to trim from the start to the specified length.
audio_settingNoAudio mode: auto (default, model decides) or origin (keep original audio).
enable_prompt_expansionNoEnable automatic prompt optimization before generation. Default: off.
seedNoRandom seed for reproducible results. Use -1 for a random seed.

How to Use

  1. Upload your video — provide the source clip to edit via URL or drag-and-drop.
  2. Write your prompt — describe exactly what should change (e.g., “Change the motorcycle’s color to blue.”).
  3. Add reference images (optional) — upload images to guide the look of elements or styles in the edit.
  4. Add negative prompt (optional) — specify elements you want to exclude from the output.
  5. Select resolution — 720p for standard output, 1080p for higher-quality results.
  6. Set duration (optional) — leave at 0 to match the input video length, or set 2–10 to trim.
  7. Set audio_setting (optional) — choose auto or origin to preserve original audio.
  8. Enable prompt expansion (optional) — let the model automatically enrich your prompt.
  9. Set seed (optional) — fix the seed to reproduce a specific result in future runs.
  10. Submit — generate, preview, and download your edited video.

Pricing

Duration720p1080p
5s$0.50$0.75
10s$1.00$1.50

Billing Rules

  • 720p: $0.10 per second
  • 1080p: $0.15 per second (1.5× base rate)
  • Minimum billed duration: 2 seconds
  • Maximum billed duration: 10 seconds

Best Use Cases

  • Color & Style Changes — Swap object colors, materials, or visual styles across the entire clip.
  • Object Replacement — Replace specific elements in the video with different objects or variants.
  • Scene Adjustments — Change background mood, lighting, or environment without reshooting.
  • E-commerce — Edit product videos to showcase different variants or settings from a single source clip.
  • Content Iteration — Rapidly test multiple edit directions on the same source footage.

Pro Tips

  • Be specific and descriptive in your prompt — the more detail you provide, the more accurate the edit.
  • Upload reference images when you want the model to match a specific target appearance or style.
  • Use negative_prompt to prevent edits from bleeding into areas you want to preserve.
  • Enable prompt expansion for shorter or less detailed prompts to get richer output automatically.
  • Use 720p to test your edit direction before committing to a 1080p final render.

Notes

  • Both video and prompt are required fields; all other parameters are optional.
  • Billed duration is clamped between 2 and 10 seconds regardless of actual video length.
  • Ensure video and image URLs are publicly accessible if using links rather than direct uploads.
  • Please ensure your content complies with Alibaba’s usage policies.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/alibaba/wan-2.7/video-edit" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "720p",
    "audio_setting": "auto",
    "enable_prompt_expansion": false,
    "seed": -1
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
videostringYes-The source video to edit.
imagesarrayNo[]-List of reference images for video editing (0-3 images, optional).
negative_promptstringNo-The negative prompt for the generation.
resolutionstringNo720p720p, 1080pThe resolution of the generated video.
durationintegerNo-2 ~ 10Duration of the output video in seconds. Default 0 means use input video length (max 10s). Set [2-10] to trim from 0s to specified length.
audio_settingstringNoautoauto, originAudio setting. 'auto' (default): model decides based on prompt content. 'origin': keep original audio from input video.
enable_prompt_expansionbooleanNofalse-If set to true, the prompt optimizer will be enabled.
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsobjectArray of URLs to the generated content.
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.