2026-11-11 · 5 min read
How to add captions to wedding videos with an API
Wedding videos carry some of the most quotable words people ever record: vows, toasts, a parent's speech. Videographers increasingly deliver short captioned cuts for social alongside the full film, and captioning each clip by hand eats editing time during the busiest season. caption.sh turns that step into an API call.
Where captions fit in a wedding deliverable
- Vow and speech excerpts for Instagram and TikTok, where text on screen helps a viewer follow along even with the sound low.
- Highlight reels for the couple's family group chats, where relatives may watch without headphones.
- Teaser cuts sent before the full film, where captions carry the emotional lines that sell the story.
- Accessible versions for family members who are hard of hearing, paired with platform captions for adjustable text.
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/vows-cut.mp4",
"options": {
"font": "inter",
"caps": False,
"position": "bottom",
"max_words": 4,
"max_lines": 2,
"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, so pull the file into your delivery folder right away.
Styling for wedding footage
Wedding color grading is usually soft and bright, so heavy caption styling fights the footage. Lowercase text (caps off), a modest max_words, and a light translucent backdrop tend to sit well over bright skin tones and white dresses. Skip the karaoke highlight for vows; a calm static caption reads more like a film subtitle and less like a social edit. For energetic reception cuts, the highlight style fits better.
Accuracy and limits
- Outdoor ceremonies mean wind and distance from the mic. Transcription accuracy follows the audio quality, so review the spoken lines against the captions before delivering; vows in particular deserve a word-perfect check.
- Music under a speech can lower accuracy. If your edit ducks the music cleanly, submit that mix.
- Each job accepts up to 10 minutes. Long ceremony films should be cut into the segments you actually plan to caption rather than submitted whole.
- At $0.10 per minute prepaid, captioning a 3-minute highlight costs $0.30, small against a wedding package price.
Burned-in captions cannot be toggled, resized, or translated by the viewer. For the full-length film, deliver through a player that supports switchable captions as well, so family members who need larger text have it.