AI Video Editor Auto Clip Highlight Short Video API on WaveSpeedAI

Name: AI Video Editor Auto Clip Highlight Short Video
Brand: wavespeed-ai
SKU: wavespeed-ai/ai-video-editor/auto-clip
Price: 0.5 USD
Availability: InStock

README

AI Video Editor — Auto Clip

Auto Clip cuts long or raw footage down to one short clip, typically 15–60 seconds and never longer than 120. It is a clipping tool rather than a full-length editor: it decides what is worth keeping and returns a single short video. Upload one or several source videos, optionally describe the topic, style, or target length, and the editor reviews the footage, selects the most relevant moments, arranges them into a coherent sequence, and adds captions when verified speech is available.

Use Auto Clip when you want the AI to decide which parts of the footage should make the final cut. It is designed for turning long recordings, multiple clips, product footage, events, tutorials, interviews, or other raw material into a concise highlight or social-ready video without manually reviewing and assembling the timeline.

Why Choose This?

Automatic video editing
Turn raw footage into a finished short-form edit without manually selecting clips or arranging a timeline.
Whole-source review
Source footage is reviewed before moments are selected, helping the edit focus on relevant content rather than simply using the beginning of the video.
Prompt-guided editing
Describe the topic, editing direction, or desired length, such as a 30-second highlight of the finished result.
Works with spoken and visual content
Spoken footage is edited around complete sentences. When usable speech is unavailable, the editor can select content based on what is visible while retaining the original audio.
Multi-video support
Combine up to 8 source videos into a single finished edit.
Flexible aspect ratios
Create landscape, vertical, square, portrait, or ultrawide output for different platforms and publishing workflows.
Captions under your control
Word-by-word highlighted captions by default, plain static captions, or none at all with caption_style. Captions are generated only for verified speech and are repositioned when the source already contains burned-in subtitles.

Parameters

Parameter	Required	Description
videos	Yes	Source videos provided as URLs or uploads. Supports `1–8` videos. Up to `2` hours of each video are processed; longer inputs are truncated.
prompt	No	Optional instructions describing what the edit should focus on, its style, or desired length. Leave empty to let the editor determine the edit automatically.
aspect_ratio	No	Output aspect ratio: `16:9`, `9:16`, `1:1`, `4:5`, `5:4`, `4:3`, `3:4`, `3:2`, `2:3`, or `21:9`. If omitted, the output follows the source video.
caption_style	No	Burned-in captions: `highlight` (default) lights up each word as it is spoken, `plain` shows static caption lines, `none` adds no captions.
language	No	Language spoken in the source: `auto`, `en`, `fr`, `es`, `pt`, `it`, `ru`, `zh-CN`, `zh-TW`, `ja`, `ko`. `auto` (default) detects it. Set it when detection is unreliable, such as heavy accents, loud background music or very little speech. For Chinese it also selects the caption script: `zh-CN` simplified, `zh-TW` traditional.

Output

outputs lists the edited MP4 first, followed by its SRT subtitle file. The subtitles are also embedded in the MP4 as a soft subtitle track (off by default), so players such as QuickTime, VLC and video editors can switch them on. The SRT file is returned with every caption_style, including none.

How to Use

Upload source videos — Provide between 1 and 8 videos to edit.
Describe the clip (optional) — Use prompt to specify the topic, style, focus, or desired output length.
Choose a caption style (optional) — Use caption_style to keep word-by-word highlighting, switch to plain captions, or turn captions off.
Choose aspect ratio (optional) — Select a landscape, vertical, square, or other supported format, or omit it to follow the source.
Choose language (optional) — Select the spoken language or keep auto for automatic detection.
Submit — Let the editor review the footage, select relevant moments, arrange the cut, and generate captions when applicable.
Retrieve the result — Download the completed edited video.

Pricing

Billing follows the combined length of every source video, per started hour.

Total source footage	Billed	Cost
10 min	1 hour	$0.50
1 hour	1 hour	$0.50
90 min	2 hours	$1.00
3 videos of 1 hour	3 hours	$1.50

Billing Rules

$0.50 per started hour of combined source footage, with a 1-hour minimum.
The length of the finished clip does not affect the price, and aspect_ratio, caption_style and language add no separate charge.

Best Use Cases

Long recordings — Reduce lectures, streams, webinars, or walkthroughs to their key moments.
Multi-clip footage — Combine several takes or angles of the same subject into one clip.
Tutorials and projects — Show the key steps and the finished result rather than the whole process.
Events and travel — Turn hours of footage into a short, shareable clip.
Social formats — Produce vertical or square clips for short-form feeds.

Pro Tips

Name the outcome you want in prompt, such as the key steps and the finished result, rather than only a topic.
State a target length in the prompt when it matters; otherwise the clip length follows the content.
With several videos, each one receives a share of the clip. When there are more videos than the length can carry, the best-matching ones are kept and played in source order.
Footage without usable speech is selected by what is visible, in chronological order, so a process still ends on its result.
Use 9:16 for vertical feeds and leave aspect_ratio unset to keep the original framing.

Notes

videos is required and supports between 1 and 8 source videos.
Maximum input size is 2 GB per video.
Processing usually takes 4–10 minutes and depends only slightly on the source length.
Output is one short clip: typically 15–35 seconds without a prompt, and at most 120 seconds.
When a target length is specified in the prompt, the editor uses it to guide the output duration.
Spoken content is edited around complete sentences when usable speech is available.
Footage without usable speech is edited based on visible content in chronological order while retaining the original audio.
Captions are generated only for speech that can be verified.
When burned-in subtitles are detected in the source, generated captions are positioned to avoid covering them.
When changing aspect ratio, the full source frame is retained and remaining canvas space is filled with a blurred copy of the footage.

Ai Video Editor Auto Clip API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/wavespeed-ai/ai-video-editor/auto-clip 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 Ai Video Editor Auto Clip below.

HTTP example

set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "videos": [
        "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
    ],
    "aspect_ratio": "16:9",
    "caption_style": "highlight",
    "language": "auto"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/ai-video-editor/auto-clip" \
  -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/wavespeed-ai/ai-video-editor/auto-clip";
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({
        "videos": [
                "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
        ],
        "aspect_ratio": "16:9",
        "caption_style": "highlight",
        "language": "auto"
}),
});
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 = {
    "videos": [
        "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
    ],
    "aspect_ratio": "16:9",
    "caption_style": "highlight",
    "language": "auto"
}

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/wavespeed-ai/ai-video-editor/auto-clip", 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)

Ai Video Editor Auto Clip API — Frequently asked questions

What is the Ai Video Editor Auto Clip API?

Ai Video Editor Auto Clip is a WaveSpeedAI model for video editing, exposed as a REST API on WaveSpeedAI. AI Video Editor Auto Clip cuts long or raw footage down to a short highlight clip: it reviews one or several videos end to end, picks the moments that matter, follows your prompt for topic, style and length, and delivers a captioned clip of roughly 15 to 60 seconds. 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 Ai Video Editor Auto Clip 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 Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/wavespeed-ai/ai-video-editor-auto-clip.

How much does Ai Video Editor Auto Clip cost per run?

Ai Video Editor Auto Clip starts at $0.5 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 Ai Video Editor Auto Clip accept?

Key inputs: `prompt`, `aspect_ratio`, `caption_style`, `language`, `videos`. 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/wavespeed-ai/ai-video-editor-auto-clip.

How do I get started with the Ai Video Editor Auto Clip 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 Ai Video Editor Auto Clip outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (WaveSpeedAI). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

wavespeed-ai/ai-video-editor/auto-clip

ExamplesView all

Related Models