2026-11-13 · 5 min read

How to add captions to car dealership videos with an API

A film strip of car scenes, the middle frame showing the captioned word AUTO in neon
This image was generated with AI.

Dealership video sells the car before the customer visits: walkarounds, feature highlights, trade-in explainers, delivery congratulations. Most of it gets watched in a feed without sound, and the details that move a buyer, trim, price, mileage, warranty, live in the voiceover. caption.sh adds the captions with an API call.

Where captions fit for dealerships

  • Walkaround videos where the salesperson narrates features while the camera moves around the car.
  • New-arrival and inventory clips posted to Facebook, Instagram, and TikTok.
  • Financing and trade-in explainers where numbers need to be read, not just heard.
  • Service-department content: maintenance tips and recall information.

The workflow

import requests, time

API = "https://api.caption.sh/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

job = requests.post(
    f"{API}/videos",
    headers=HEADERS,
    json={
        "source_url": "https://your-cdn.example/walkaround.mp4",
        "options": {
            "font": "inter",
            "position": "bottom",
            "max_words": 4,
            "max_lines": 2,
            "highlight": True,
            "highlight_color": "#EF4444",
            "backdrop_opacity": 0.35,
        },
    },
).json()
job_id = job["job_id"]

for _ in range(120):
    job = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS).json()
    if job["status"] in ("done", "error"):
        break
    time.sleep(5)

if job["status"] == "done":
    r = requests.get(f"{API}/jobs/{job_id}/result", headers=HEADERS,
                     allow_redirects=False)
    video_url = r.headers["Location"]

Jobs run queued, awaiting_upload, running, then done or error; poll until a terminal status. The result endpoint answers 302, so read the Location header with redirects disabled. Results are stored for 24 hours, then deleted.

Styling for dealership footage

Walkarounds are handheld and the background changes constantly: bottom position with a modest backdrop_opacity keeps text readable over paint, glass, and lot asphalt. max_words at 4 keeps trim names and feature phrases intact. Always spot-check the numbers: prices, mileage, and payments are the captions a buyer remembers, and spoken digits deserve a quick accuracy pass before posting.

Tradeoffs and cost

  • Burned-in captions cannot be toggled, resized, or translated. Keep platform captions enabled where the player supports them.
  • Each job covers up to 10 minutes. A long test-drive or delivery video should be cut into segments first.
  • A 429 means the transcription throughput ceiling is reached. Wait and retry rather than submitting duplicates.
  • At $0.10 per minute prepaid, a two-minute walkaround costs $0.20 per vehicle.

Back to all articles