2026-11-16 · 5 min read
How to add captions to fashion videos with an API
Fashion video moves fast: hauls, styling tips, get-ready-with-me, runway recaps. The commentary carries the brand names, the sizes, the prices, and the styling logic, and most of the audience watches in a feed where sound is a choice. caption.sh adds the captions with an API call.
Where captions fit in fashion content
- Hauls where every item name, size, and price needs to be readable as it flashes by.
- Styling videos where the reasoning matters as much as the look.
- GRWM and outfit-of-the-day clips where commentary is half the appeal.
- Brand lookbooks and drop announcements with voiceover.
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/styling-video.mp4",
"options": {
"font": "inter",
"position": "center",
"max_words": 3,
"max_lines": 2,
"caps": True,
"highlight": True,
"highlight_color": "#EC4899",
"outline_width": 2,
},
},
).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.
Brand names and fast cuts
Fashion vocabulary is hard for any transcription: designer names, fabric terms, and borrowed words from French and Italian. Spot-check brand names before publishing, since a misspelled label is the comment section's favorite catch. For hauls with rapid item changes, max_words at 3 keeps each item's text on screen long enough to read.
Tradeoffs and cost
- Burned-in captions cannot be toggled, resized, or translated. Keep platform captions enabled for viewers who need adjustable text.
- Each job covers up to 10 minutes, well past any haul or GRWM.
- A 429 means the transcription throughput ceiling is reached. Wait and retry rather than submitting duplicates.
- At $0.10 per minute prepaid, captioning a 2-minute styling video costs $0.20.