Skip to main content
POST
Prepare Video

POST /api/v1/hooks/prepare

Prepare multiple episode files into a continuous video with smart transitions. The AI analyzes episode boundaries, removes freeze frames, and eliminates overlapping recap content for seamless playback.

Parameters

Response

Example Request

Example Response

Notes

  • Supports common video formats: mp4, mov, avi, mkv
  • AI automatically detects and removes freeze frames between episodes
  • Overlapping recap content at episode starts is intelligently trimmed
  • The transcript includes word-level timestamps for precise hook generation
  • Use the returned URLs with the Generate Hook endpoint

Body

multipart/form-data
videos
file[]
required

Episode video files to merge into continuous video

Response

Video prepared successfully

continuous_video_url
string<uri>
required

URL to the merged continuous video

Example:

"https://cdn.usenarrative.ai/prepared/continuous_abc123.mp4"

transcript_url
string<uri>
required

URL to the transcript JSON file

Example:

"https://cdn.usenarrative.ai/prepared/transcript_abc123.json"

total_duration_sec
number
required

Total duration of the continuous video in seconds

Example:

5234.5

episodes_processed
integer
required

Number of episodes that were merged

Example:

3