GPT Image 2.5 is LIVE — Flare & Sunburst | Try in Image Generator →

alibaba/

Wan 3.0 Video Edit edits existing videos with text prompts and optional reference images or audio, supporting prompt-guided scene changes, visual refinements, and multimodal video editing. Inputs longer than 15 seconds are trimmed to the first 15 seconds, with output aspect ratio automatically matched to the input video. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

video-to-video
Input
Enable Safety Checker

Idle

$0.5per run·~20 / $10

Next:

ExamplesView all

Edit video 1: make the lighting warm golden-hour sunlight. Preserve the original subjects, composition, actions and camera motion.

Related Models

README

Wan 3.0 Video Edit

Wan 3.0 Video Edit edits an existing video with natural-language instructions. Provide a source video, describe the changes you want, and optionally add reference images or audio to guide the result.

The source video is processed as video reference input, while the prompt controls the requested edit, motion, appearance, scene changes, and other transformations.

Why Choose This?

  • Prompt-based video editing
    Edit an existing video using natural-language instructions.

  • Multimodal reference guidance
    Add reference images and audio to provide additional visual or audio context.

  • Flexible output duration
    Generate an edited result from 2 to 15 seconds.

  • 480p, 720p, and 1080p output
    Choose the resolution that fits your quality and cost requirements.

  • Audio control
    Generate audio with the edited video or preserve the source audio track when available.

  • Prompt expansion
    Enable prompt expansion when you want the input instruction optimized automatically.

Parameters

ParameterRequiredDescription
promptYesEditing instruction describing the desired result. Refer to uploaded assets as Video 1, Image 1, or Audio 1 when needed.
videoYesInput video URL. Videos longer than 15 seconds are trimmed to the first 15 seconds; videos shorter than 1 second are padded.
reference_imagesNoOptional reference images for visual guidance. Supports up to 10 images.
reference_audiosNoOptional reference audio clips. Supports up to 5 clips, normalized to a combined maximum of 15 seconds.
durationNoOutput duration in seconds. Range: 2–15. If omitted, it follows the normalized source duration rounded up to a whole second, with a minimum of 2 seconds.
resolutionNoOutput resolution: 480p, 720p, or 1080p. Default: 720p.
generate_audioNoWhether to generate audio for the output. Default: true. When false, the source audio track is preserved when available.
enable_prompt_expansionNoEnable automatic prompt expansion. Default: false.
seedNoRandom seed for generation. Use -1 for a random seed.

How to Use

  1. Upload a source video — Provide the video you want to edit.
  2. Write an editing prompt — Describe the requested changes clearly.
  3. Add reference images optional — Provide up to 10 images when additional visual guidance is useful.
  4. Add reference audio optional — Provide up to 5 audio clips when audio reference guidance is needed.
  5. Set output duration optional — Choose a duration from 2 to 15 seconds, or omit it to follow the processed source duration.
  6. Choose resolution — Select 480p, 720p, or 1080p.
  7. Configure audio — Keep generate_audio=true for generated audio, or disable it to preserve the source audio track when available.
  8. Configure prompt expansion optional — Enable enable_prompt_expansion when you want the instruction expanded automatically.
  9. Set seed optional — Use a fixed seed for reproducible generation, or -1 for random generation.
  10. Submit — Generate the edited video and retrieve the output.

Pricing

Pricing is based on the normalized input video duration plus the output video duration.

The input video duration is rounded up to the next whole second and limited to 1–15 seconds.

If duration is omitted, the output duration follows the normalized input duration, with a minimum of 2 seconds and a maximum of 15 seconds.

ResolutionPer Billed Second
480p$0.05
720p$0.10
1080p$0.20

Billing Examples

Input VideoOutput DurationTotal Billed Duration480p720p1080p
1sDefault → 2s3s$0.15$0.30$0.60
5sDefault → 5s10s$0.50$1.00$2.00
5s10s15s$0.75$1.50$3.00
10sDefault → 10s20s$1.00$2.00$4.00
15sDefault → 15s30s$1.50$3.00$6.00

For example, a 5s source video with a 10s requested output at 720p is billed for 15 total seconds:

(5 + 10) × $0.10 = $1.50

reference_images, reference_audios, generate_audio, enable_prompt_expansion, and seed do not add separate charges.

Best Use Cases

  • Prompt-based video editing — Modify an existing video using natural-language instructions.
  • Appearance changes — Adjust clothing, objects, environments, colors, or visual styling.
  • Scene transformation — Change backgrounds, environments, lighting, or atmosphere.
  • Reference-guided editing — Use images or audio to guide the desired result.
  • Creative video workflows — Transform existing footage into new visual concepts.
  • Short-form content editing — Create edited clips for social media, advertising, and creative production.

Pro Tips

  • Describe exactly what should change and what should remain unchanged.
  • Refer to supplied assets clearly as Video 1, Image 1, or Audio 1.
  • Use reference images when appearance, character, object, or style consistency matters.
  • Keep reference audio focused on the sound or performance you want to guide.
  • Use 480p for lower-cost testing before moving to higher resolutions.
  • Remember that both the processed input duration and output duration contribute to the final price.
  • Set a fixed seed when comparing different prompts or parameter changes.

Notes

  • prompt and video are required.
  • Source videos longer than 15 seconds are trimmed to the first 15 seconds.
  • Source videos shorter than 1 second are normalized to at least 1 second.
  • Output duration supports 2–15 seconds.
  • If duration is omitted, it follows the normalized source duration with a minimum of 2 seconds.
  • Up to 10 reference images are supported.
  • Up to 5 reference audio clips are supported, with a combined normalized maximum of 15 seconds.
  • Output aspect ratio is selected automatically from the input video's display dimensions.
  • Nonstandard source aspect ratios are mapped to the nearest supported ratio and may change framing.
  • generate_audio=false preserves the source audio track when one is available.

Related Models

Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

Wan 3.0 Video Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/alibaba/wan-3.0/video-edit with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for Wan 3.0 Video Edit below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
    "resolution": "720p",
    "generate_audio": true,
    "enable_prompt_expansion": false
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/alibaba/wan-3.0/video-edit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/wan-3.0/video-edit";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
        "resolution": "720p",
        "generate_audio": true,
        "enable_prompt_expansion": false
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
    "resolution": "720p",
    "generate_audio": True,
    "enable_prompt_expansion": False
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/wan-3.0/video-edit", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

Wan 3.0 Video Edit API — Frequently asked questions

What is the Wan 3.0 Video Edit API?

Wan 3.0 Video Edit is a Alibaba model for video editing, exposed as a REST API on WaveSpeedAI. Wan 3.0 Video Edit edits existing videos with text prompts and optional reference images or audio, supporting prompt-guided scene changes, visual refinements, and multimodal video editing. Inputs longer than 15 seconds are trimmed to the first 15 seconds, with output aspect ratio automatically matched to the input video. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Wan 3.0 Video Edit API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates production-oriented Python, JavaScript, and cURL examples with timeouts, transient-error handling, and safe GET retries. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/alibaba/alibaba-wan-3.0-video-edit.

How much does Wan 3.0 Video Edit cost per run?

Wan 3.0 Video Edit starts at $0.50 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Wan 3.0 Video Edit accept?

Key inputs: `prompt`, `video`, `resolution`, `seed`, `reference_images`, `enable_prompt_expansion`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/alibaba/alibaba-wan-3.0-video-edit.

How do I get started with the Wan 3.0 Video Edit API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Wan 3.0 Video Edit outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Alibaba). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

Wan 3.0 Video Edit API on WaveSpeedAI