2026-11-15 · 5 min read
How to add captions to nonprofit videos with an API
Nonprofit video carries the mission: fundraising appeals, impact stories, volunteer spotlights, event recaps. Much of the audience watches without sound, and accessibility is often a stated value of the organization itself, so captions are not a nice-to-have. caption.sh adds them with an API call at a price a small team can actually plan around.
Where captions fit for nonprofits
- Fundraising appeals where the story and the ask need to land in a silent feed.
- Impact stories and beneficiary interviews, where dignity and accuracy both matter.
- Event recaps and gala highlights posted across social.
- Volunteer recruitment and training clips shared with chapters.
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/impact-story.mp4",
"options": {
"font": "inter",
"position": "bottom",
"max_words": 4,
"max_lines": 2,
"highlight": True,
"highlight_color": "#FBBF24",
"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.
Accuracy and dignity
Nonprofit content often features real people telling personal stories, and names and places deserve a review pass before publishing. The generated captions give you a timed draft to check against rather than a transcript to type from scratch, which is where the time saving lands.
Tradeoffs and cost
- Accessibility is usually the point, so note the tradeoff: burned-in captions cannot be toggled, resized, or translated. Pair them with platform captions wherever the player supports it.
- Each job covers up to 10 minutes. Longer event recordings should be segmented first.
- A 429 means the transcription throughput ceiling is reached. Wait and retry rather than submitting duplicates.
- At $0.10 per minute prepaid, captioning a 3-minute appeal costs $0.30, which keeps captioning within reach of a one-person comms shop.