Video Colorizer API Documentation

Video Colorizer API Documentation

Playground

Video Colorizer restores natural color to black-and-white, monochrome or faded footage while keeping every subject, the framing and the motion exactly as they are. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Bring black-and-white footage to life. Video Colorizer restores natural, believable color to grayscale, monochrome or heavily faded video while keeping every subject, the framing and the motion exactly as they are. Colors are inferred from the footage automatically; describe them yourself when you want a specific look.

What It Does

• Natural colors, automatically The scene is analysed and each element gets its real-world color: skin tones, foliage, sky, water, stone, fabrics and lights.

• Nothing else changes Subject identity, framing and background geometry are preserved frame for frame; only the color information is added.

• Your colors when you want them Pass a prompt naming things and their colors (“green grass, blue sky, a red jacket”) to steer the result.

Parameters

Pro Tips

• Name colors explicitly in prompt (“terracotta roofs, ochre walls, golden street lights”); vague words like “natural” or “vivid” on their own do little.
• Old film scans: run through a restoration or upscaling tool first if the source is heavily damaged; the colorizer is not a denoiser.
• Keep the same seed to reproduce a result.

Limits and Performance

• Max clip length per job: 2 minutes (longer input is truncated)
• Processing speed: roughly 8 seconds of wall time per second of video at 720p, about 20 seconds per second at 1080p

Pricing

> Billing duration: Input media duration is rounded up to whole seconds. The minimum billed duration is 3 seconds; shorter inputs are billed as 3 seconds. Input beyond 2 minutes is not processed and not billed.

Per-second billing with a 3-second minimum. The table below lists prices per 5 seconds for easy comparison.

Billing Rules

• Minimum charge: 3 seconds
• Per-second rate = (price per 5 seconds) ÷ 5
• Billed duration = video length in seconds (rounded up), with a 3-second minimum, capped at 120 seconds
• Total cost = billed duration × per-second rate (by output resolution)

Notes

• Video is the only required field.
• Maximum processed video length per job: 2 minutes.
• Ensure video URLs are publicly accessible.

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'
{
  "video": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
  "target_resolution": "720p"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/video-colorizer" \
  -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