Skip to main content
You need a CaptionCraft API key, prepaid seconds, and a supported video URL. The shell examples use curl and jq.
1

Configure your environment

Use the endpoint provided with your API key.
Set CAPTIONCRAFT_API_KEY through your secret manager or shell environment. Replace the sample URL below with your own direct video URL:
2

Submit your video

Videos can be up to 600 seconds long. After inspecting the video, the API reserves its actual duration rounded up to a whole second. Your available balance must cover that duration before transcription can start.
A successful submission returns 202 Accepted:
This confirms the job was accepted. It does not mean the video is ready. Each accepted submission creates a new job, even with identical input.
3

Poll and download

Using the cURL submission above, poll until the job reaches a terminal state:
Download URLs do not need the API key. Save all three files within 24 hours of completion. If a poll returns 429, wait at least the Retry-After interval and retry that poll.

Next steps

Customize your captions

Explore presets, positioning, and colors.

Handle job states

Add progress, cancellation, and retry handling.