Guides

Image Background

Use a custom background image in final output.

Workflow

  1. Upload your background image and get a URL.
  2. Create job with bg_type=image and bg_image_url.
  3. Start and poll status until completed.

Best Practices

  • Match output aspect ratio with source video.
  • Use high-resolution backgrounds to avoid blur.
  • Add light/shadow matching in downstream composition if needed.

Quality Guardrails

  • Prefer representative source clips when tuning model defaults.
  • Keep input compression moderate to preserve edge details.
  • Use explicit output format policy for transparent vs non-transparent workflows.
  • Run A/B validation with the same clip set before changing defaults.

Implementation Checklist

  1. Define payload schema validation in backend before forwarding requests.
  2. Store model/output_format/background settings with each job record.
  3. Add internal quality review for difficult scenes (hair, glass, motion blur).
  4. Create runbook entries for model-specific failure cases.

Background Image Performance

Aspect Ratio MatchExpected Result
Exact matchBest visual quality and no crop/stretch
Close matchMinor crop or padding may appear
Large mismatchNoticeable distortion risk