AI Video Editor Auto Edit API Documentation

AI Video Editor Auto Edit API Documentation

Playground

AI Video Editor Auto Edit turns raw footage into a short, watchable cut: it finds the moments that matter across one or several videos, follows your prompt for topic, style and length, and delivers a finished edit with captions. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Auto Edit turns raw footage into a short, finished video by automatically deciding what is worth keeping. 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 Edit 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.

• Caption-aware editing
  Captions are generated only for verified speech and can be repositioned when the source already contains burned-in subtitles.

Parameters

How to Use

1. Upload source videos — Provide between 1 and 8 videos to edit.
2. Describe the edit optional — Use prompt to specify the topic, style, focus, or desired output length.
3. Choose aspect ratio optional — Select a landscape, vertical, square, or other supported format, or omit it to follow the source.
4. Choose language optional — Select the spoken language or keep auto for automatic detection.
5. Submit — Let the editor review the footage, select relevant moments, arrange the cut, and generate captions when applicable.
6. Retrieve the result — Download the completed edited video.

Pricing

Billing Rules

• Billed by the combined length of all source videos, per started hour: $0.50 per hour, 1-hour minimum.
• The length of the finished edit does not affect the price.

Notes

• Translated voiceover takes considerably longer than a same-language edit.
• videos is required and supports between 1 and 8 source videos.
• Maximum input size is 2 GB per video.
• When no prompt is provided, output videos are typically around 15–35 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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "videos": [
    "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
  ],
  "aspect_ratio": "16:9",
  "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-edit" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; 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 type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  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

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters