> ## Documentation Index
> Fetch the complete documentation index at: https://docs.captioncraft.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Captions that make every word count. One API, ready for your workflow.

## Your video. Captioned.

CaptionCraft turns a video URL into a captioned MP4, an SRT subtitle file, and a JSON transcript with word-level timestamps. Add captions to your application, automation, or AI agent with a single request.

<div className="cc-demo" aria-label="Illustration of a highlighted caption">
  <div className="cc-demo-label">CAPTIONCRAFT · HIGHLIGHT</div>
  <div className="cc-demo-caption">Make every <mark>word</mark> count.</div>
  <div className="cc-demo-output"><span>Captioned MP4</span><span>SRT subtitles</span><span>JSON transcript</span></div>
</div>

<Note>
  API requests require a CaptionCraft API key and sufficient prepaid video seconds.
</Note>

## How it works

<Steps>
  <Step title="Provide a video URL">
    Host your video at a direct, publicly reachable HTTPS URL. MP4, MOV, and WebM are supported up to 500 MiB and 1080p in landscape or portrait. The video must contain speech and an audio track.
  </Step>

  <Step title="Create a caption job">
    Call [Create subtitles](/api-reference/create-subtitles), choose a preset, and set a duration limit. The API returns a job ID and a status URL immediately.
  </Step>

  <Step title="Check progress">
    Poll [Get job](/api-reference/get-job) every five seconds while your video is downloaded, transcribed, and rendered.
  </Step>

  <Step title="Download your results">
    When the status is `completed`, download the video, subtitles, and transcript. Results are retained for 24 hours; copy them to your own storage before they expire.
  </Step>
</Steps>

## Start building

<CardGroup cols={2}>
  <Card title="Quickstart" icon="terminal" href="/quickstart">Submit your first video and retrieve the results.</Card>
  <Card title="API reference" icon="code" href="/api-reference/create-subtitles">Explore request fields and response examples.</Card>
  <Card title="Caption styles" icon="captions" href="/caption-styles">Choose Classic, Highlight, or Karaoke.</Card>
  <Card title="Authentication" icon="key-round" href="/authentication">Connect with a scoped Bearer API key.</Card>
</CardGroup>

## Build with AI

The **OpenAPI** button in the header opens the machine-readable JSON specification: endpoints, authentication, request fields, and response schemas. Download it to import the API into compatible tools.

Use the [OpenAPI specification](/openapi.json) to describe the API to a connector or agent. The [AI integration guide](/ai-integrations) covers job polling, retries, and downloadable documentation.