curl and jq.
1
Configure your environment
Use the endpoint provided with your API key.
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.