API docs/workflows/static-background-video

Static background video

Voiced captions over a looping background (gameplay, satisfying clips, ...).

Requiressource.text or source.url
media: moving-imagevoice-over: on by defaultmusic: on by defaultcaptions: on by defaultratio: 9:16 by default

Build your request

Only the parameters that apply to static-background-video are shown. Set values on the left, copy the payload on the right.

View as Markdown (for LLMs)
source.textrequired

The exact script to be spoken. For script-to-video it can also be an X/Twitter or LinkedIn post URL: the post content becomes the script.

source.url

The source content URL: audio file, video file, YouTube link, Spotify track, article page, or PDF depending on the workflow. http(s) is enforced; bare domains get https:// prepended.

{
  "workflow": "static-background-video",
  "source": {
    "text": "Here are 3 psychology tricks that actually work."
  },
  "media": {
    "backgroundVideo": {
      "type": "video",
      "url": "https://cdn.revid.ai/backgrounds/minecraft/color-upscaled.mp4"
    }
  }
}
Free, no API key needed.

Good to know

  • Set the loop with media.backgroundVideo ({ type: "video", url, ... }). Without it, Revid falls back to default backgrounds.
  • backgroundVideo.noReencode = true skips re-encoding for known-good mp4 sources (faster renders).