2026-11-12 · 5 min read

How to add captions to video sales letters with an API

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

A video sales letter lives or dies on whether people keep watching, and a viewer who cannot play sound still needs the pitch. Captions keep the words on screen through the whole argument: the problem, the mechanism, the proof, the offer. caption.sh adds them with an API call instead of an editing session.

Why caption a VSL

  • Landing pages get traffic from places where audio is inconvenient: offices, waiting rooms, quiet cars on a train.
  • VSLs are long. On-screen text gives skimmers a way to follow the argument when they would otherwise bounce.
  • Ad-platform cuts of the same video carry the captions everywhere they get reposted.
  • Key phrases, prices, and guarantees stay visible exactly when they are spoken.

The workflow

VSLs often run past the 10-minute per-job limit, so the pattern is: split the video into segments, caption each, and either deliver the segments or stitch them after. Cost is just the per-minute price times total length.

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/vsl-part-1.mp4",
        "options": {
            "font": "inter",
            "position": "bottom",
            "max_words": 4,
            "max_lines": 2,
            "highlight": True,
            "highlight_color": "#F59E0B",
        },
    },
).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, so pull each MP4 as its job finishes.

Styling for sales content

  • VSLs are deliberate, not frantic: max_words at 4 with a calm highlight keeps the pace readable instead of hyper.
  • Keep position at bottom and leave the lower third clear if your edit shows a call-to-action button or price anchor there.
  • Test one segment before captioning the full set; VSL delivery has rhetorical pauses that deserve a quick accuracy check on names and numbers.

Tradeoffs and cost

  • Burned-in captions cannot be toggled, resized, or translated. If your player supports switchable captions, offer those too for viewers who need adjustable text.
  • A 429 means the transcription throughput ceiling is reached. Wait and retry rather than submitting duplicates.
  • At $0.10 per minute prepaid, a 20-minute VSL split into two segments costs $2.00 total.

Back to all articles