Wan 3.0 Prime Video Edit API on WaveSpeedAI

Wan 3.0 Prime Video-Edit

Wan 3.0 Prime Video-Edit edits an existing video with natural-language instructions. Upload a source video, describe the changes you want, and optionally provide reference images or audio for additional guidance.

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

Why Choose This?

Prompt-based video editing
Transform an existing video using natural-language instructions.
Multimodal reference guidance
Add reference images and audio clips to guide visual appearance, characters, objects, or sound-related context.
Flexible output duration
Generate edited videos from 2 to 15 seconds.
480p, 720p, and 1080p output
Choose the resolution that fits your quality and cost requirements.
Audio control
Generate audio for the edited video or preserve the original source audio when available.
Prompt expansion
Enable automatic prompt expansion when you want the editing instruction optimized before generation.

Parameters

Parameter	Required	Description
prompt	Yes	Editing instruction describing the desired result. Refer to uploaded assets as `Video 1`, `Image 1`, or `Audio 1` when needed.
video	Yes	Input video URL. Videos longer than `15` seconds are trimmed to the first `15` seconds; videos shorter than `1` second are padded.
reference_images	No	Optional reference images for visual guidance. Supports up to `10` images.
reference_audios	No	Optional reference audio clips. Supports up to `5` clips, normalized to a combined maximum of `15` seconds.
duration	No	Output 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.
resolution	No	Output resolution: `480p`, `720p`, or `1080p`. Default: `720p`.
generate_audio	No	Whether to generate audio for the output. Default: `true`. When `false`, the source audio track is preserved when available.
enable_prompt_expansion	No	Enable automatic prompt expansion. Default: `false`.
seed	No	Random seed for generation. Use `-1` for a random seed.

How to Use

Upload a source video — Provide the video you want to edit.
Write an editing prompt — Clearly describe what should change and what should remain unchanged.
Add reference images optional — Provide up to 10 images for additional visual guidance.
Add reference audio optional — Provide up to 5 audio clips when audio reference guidance is useful.
Set output duration optional — Choose 2–15 seconds or omit it to follow the processed source duration.
Choose resolution — Select 480p, 720p, or 1080p.
Configure audio — Keep generate_audio=true for generated audio, or disable it to preserve source audio when available.
Configure prompt expansion optional — Enable enable_prompt_expansion when you want the instruction expanded automatically.
Set seed optional — Use a fixed seed for reproducible results, or -1 for random generation.
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 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.

Resolution	Per Billed Second
480p	$0.075
720p	$0.15
1080p	$0.30

Example Costs

Input Video	Output Duration	Total Billed Duration	480p	720p	1080p
1s	Default → 2s	3s	$0.225	$0.45	$0.90
5s	Default → 5s	10s	$0.75	$1.50	$3.00
5s	10s	15s	$1.125	$2.25	$4.50
10s	Default → 10s	20s	$1.50	$3.00	$6.00
15s	Default → 15s	30s	$2.25	$4.50	$9.00

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

(5 + 10) × $0.15 = $2.25

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

Best Use Cases

Prompt-based video editing — Modify existing footage using natural-language instructions.
Appearance changes — Change clothing, objects, colors, materials, or visual styling.
Scene transformation — Replace or modify backgrounds, environments, lighting, and atmosphere.
Reference-guided editing — Use images or audio to guide characters, objects, appearance, or creative direction.
Creative video workflows — Transform existing footage into new visual concepts.
Marketing and social content — Produce edited short-form clips for ads, campaigns, and social media.

Pro Tips

Clearly describe both what should change and what should remain unchanged.
Refer to uploaded assets consistently as Video 1, Image 1, or Audio 1.
Use reference images when character, object, appearance, or style consistency matters.
Keep reference audio focused on the sound or performance you want to guide.
Use 480p for lower-cost iteration before generating higher-resolution results.
Remember that both processed input duration and output duration contribute to the final price.
Set a fixed seed when comparing 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 automatically selected 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

Wan 3.0 Prime Image-to-Video — Generate Prime video from a first-frame image with optional last-frame guidance.
Wan 3.0 Reference-to-Video — Generate video using multimodal reference guidance.
Wan 3.0 Image-to-Video — Generate video from a first-frame image.
Wan 3.0 Text-to-Video — Generate video directly from a text prompt.

Wan 3.0 Prime Video Edit API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/alibaba/wan-3.0-prime/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 Prime 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-prime/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-prime/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-prime/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 Prime Video Edit API — Frequently asked questions

What is the Wan 3.0 Prime Video Edit API?

Wan 3.0 Prime Video Edit is a Alibaba model for video editing, exposed as a REST API on WaveSpeedAI. Wan 3.0 Prime 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 Prime 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-prime-video-edit.

How much does Wan 3.0 Prime Video Edit cost per run?

Wan 3.0 Prime Video Edit starts at $0.75 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 Prime 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-prime-video-edit.

How do I get started with the Wan 3.0 Prime 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 Prime 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.

alibaba/

ExamplesView all

Related Models

README

Wan 3.0 Prime Video-Edit

Why Choose This?

Parameters

How to Use

Pricing

Example Costs

Best Use Cases

Pro Tips

Notes

Related Models

Wan 3.0 Prime Video Edit API — Quick start

Wan 3.0 Prime Video Edit API — Frequently asked questions

Learn More

Legal

Resources

Models

Tools