Create Captions

curl --request POST \
  --url https://public.reap.video/api/v1/automation/create-captions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceUrl": "<string>",
  "uploadId": "<string>",
  "captionsPreset": "<string>",
  "language": "<string>",
  "translationLanguage": "<string>",
  "transcriptionScript": "native",
  "enableEmojis": false,
  "enableHighlights": false,
  "resolution": 720
}
'

{
  "id": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "billedDuration": 123,
  "genre": "talking",
  "topics": [
    "<string>"
  ],
  "clipDurations": [
    [
      123
    ]
  ],
  "selectedStart": 123,
  "selectedEnd": 123,
  "reframeClips": true,
  "exportResolution": 123,
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "language": "<string>",
  "dubbingLanguage": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "urls": {},
  "createdAt": 123,
  "updatedAt": 123
}

POST

automation

create-captions

Create Captions

curl --request POST \
  --url https://public.reap.video/api/v1/automation/create-captions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceUrl": "<string>",
  "uploadId": "<string>",
  "captionsPreset": "<string>",
  "language": "<string>",
  "translationLanguage": "<string>",
  "transcriptionScript": "native",
  "enableEmojis": false,
  "enableHighlights": false,
  "resolution": 720
}
'

{
  "id": "<string>",
  "title": "<string>",
  "thumbnail": "<string>",
  "billedDuration": 123,
  "genre": "talking",
  "topics": [
    "<string>"
  ],
  "clipDurations": [
    [
      123
    ]
  ],
  "selectedStart": 123,
  "selectedEnd": 123,
  "reframeClips": true,
  "exportResolution": 123,
  "captionsPreset": "<string>",
  "enableCaptions": true,
  "enableEmojis": true,
  "enableHighlights": true,
  "language": "<string>",
  "dubbingLanguage": "<string>",
  "translateTranscription": true,
  "translationLanguages": [
    "<string>"
  ],
  "transcriptionScript": "native",
  "metadata": {
    "width": 123,
    "height": 123,
    "aspectRatio": "<string>",
    "size": 123,
    "bitrate": 123,
    "fps": 123,
    "duration": 123,
    "rotation": 123,
    "resolution": 123,
    "codec": "<string>",
    "codecFullName": "<string>",
    "codecTag": "<string>",
    "format": "<string>",
    "formatFullName": "<string>"
  },
  "urls": {},
  "createdAt": 123,
  "updatedAt": 123
}

For AI agents: a documentation index is at /llms.txt. Every page is also available as markdown, just append .md to the URL.

Overview

Add professional captions to your videos using AI-powered transcription. This endpoint generates accurate captions with various styling options, emoji support, and keyword highlighting. Perfect for making content accessible and engaging on social media platforms.

Rate Limiting

This endpoint is rate limited to 10 requests per minute per API key.

You must provide either sourceUrl or uploadId, but not both.

Video Requirements

Duration

Minimum: 3 seconds
Maximum: 15 minutes

File Size

Maximum: 5 GB

Format

MP4 or MOV with valid video and audio streams

Audio Quality

Clear speech produces best transcription results

Plan Limits

Plan	Max Resolution	Concurrent Projects
Creator	1080p	3
Studio	4K (2160p)	10

Higher-tier plans allow you to process more videos simultaneously and export at higher resolutions.

The Automation API requires an active subscription. View pricing to compare plans.

Response

string

Unique project identifier

title

string

Project title (usually the filename)

thumbnail

string

Thumbnail URL for the project

billedDuration

number

Duration in seconds that will be billed to your account

status

string

Current processing status

processing - Video is being transcribed and captions are being generated
completed - Captions have been generated successfully
failed - Processing failed due to an error

projectType

string

Type of project (always “captions” for this endpoint)

source

string

Source of the video content

Upload - Uploaded file
Generic - External URL

captionsPreset

string

Caption style preset ID used

enableCaptions

boolean

Whether captions are enabled (always true for caption projects)

enableEmojis

boolean

Whether emojis are added to captions

enableHighlights

boolean

Whether keyword highlighting is enabled

language

string

Primary language of the video content

translateTranscription

boolean

Whether transcription will be translated

translationLanguages

array

Array of languages for translation

transcriptionScript

string

Script format for transcription (“native” or “roman”)

metadata

object

Video file metadata including duration, resolution, format, etc.

urls

object

Project URLs and assets (populated when processing completes)

createdAt

integer

Unix timestamp when the project was created

updatedAt

integer

Unix timestamp when the project was last updated

Example Request

curl -X POST "https://public.reap.video/api/v1/automation/create-captions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "65f1a2b3c4d5e6f7a8b9c0d1",
    "captionsPreset": "system_beasty",
    "language": "en",
    "enableEmojis": true,
    "enableHighlights": true
  }'

Example Response

Processing Workflow

Audio Extraction - Audio is extracted from the video file
Transcription - AI transcribes the speech with precise timing
Caption Generation - Captions are formatted with your chosen style
Enhancement - Emojis and highlights are added if enabled
Rendering - Final video is rendered with embedded captions

Caption Features

AI Transcription

Accurate speech-to-text with word-level timing

Style Presets

Multiple caption styles for different content types

Emoji Support

Contextual emojis added automatically

Keyword Highlights

Important words highlighted for emphasis

Best Practices

Audio Quality: Clear audio produces more accurate transcriptions
Language Selection: Specify the language for better accuracy
Style Matching: Choose presets that match your brand and content type
Translation: Use translation for multilingual audiences

Use Cases

Video Platforms

Auto-generate captions for all uploaded content at scale

Accessibility Compliance

Meet accessibility requirements with accurate, styled captions

Social Media Tools

Add caption generation to your social media management platform

Learning Management

Caption educational content for better comprehension and searchability

Next Steps

After creating a caption project:

Monitor progress with Get Project Status
Retrieve the captioned video with Get Project Clips
Download and distribute your captioned content

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

sourceUrl

string

Direct URL to a video file (alternative to uploadId)

uploadId

string

Upload ID from a previously uploaded file (alternative to sourceUrl)

captionsPreset

string | null

Caption style preset ID. Defaults to system_beasty if not specified.

language

string | null

Primary language of the video content (auto-detected if not provided)

translationLanguage

string | null

Language to translate captions to

transcriptionScript

enum<string>

default:native

Script format for transcription output

Available options:

native,

roman

enableEmojis

boolean

default:false

Whether to add contextual emojis to captions

enableHighlights

boolean

default:false

Whether to highlight keywords in captions

resolution

enum<integer>

default:720

Output resolution (only applicable when sourceUrl is provided)

Available options:

720,

1080,

1440,

2160

Response

200 - application/json

Successful response

string

title

string

thumbnail

string

billedDuration

number

status

enum<string>

Available options:

queued,

prepped,

draft,

processing,

finalizing,

completed,

invalid,

expired,

failed,

error

projectType

enum<string>

Available options:

clipping,

captions,

reframe,

dubbing,

transcription

source

enum<string>

Available options:

Upload,

Youtube,

Vimeo,

TwitchVod,

Twitter,

RumbleEmbed,

Generic

genre

enum<string>

default:talking

Available options:

talking,

screenshare,

gaming

topics

string[]

clipDurations

integer[][]

selectedStart

number | null

selectedEnd

number | null

reframeClips

boolean

exportResolution

integer

exportOrientation

enum<string>

Available options:

landscape,

portrait,

square

captionsPreset

string | null

enableCaptions

boolean

enableEmojis

boolean

enableHighlights

boolean

language

string | null

dubbingLanguage

string | null

translateTranscription

boolean

translationLanguages

string[]

transcriptionScript

enum<string>

default:native

Available options:

native,

roman

metadata

object

Show child attributes

urls

object

createdAt

integer

updatedAt

integer

Create Clips Create Transcription

​Overview

​Rate Limiting

​Video Requirements

Duration

File Size

Format

Audio Quality

​Plan Limits

​Response

​Example Request

​Example Response

​Processing Workflow

​Caption Features

AI Transcription

Style Presets

Emoji Support

Keyword Highlights

​Best Practices

​Use Cases

Video Platforms

Accessibility Compliance

Social Media Tools

Learning Management

​Next Steps

Authorizations

Body

Response

Overview

Rate Limiting

Video Requirements

Plan Limits

Response

Example Request

Example Response

Processing Workflow

Caption Features

Best Practices

Use Cases

Next Steps