# Narrative API

## Docs

- [Introduction](https://docs.narrative.video/api-reference/narrative/introduction.md): Narrative API - AI-powered product video thumbnail generation
- [Generate Dynamic Thumbnails](https://docs.narrative.video/api-reference/narrative/dynamic-thumbnails.md): Generate product thumbnails from a video URL using AI-powered frame selection. Analyzes video, samples frames, preprocesses and then selects best frames, returns base64-encoded JPEGs.
- [Generate Thumbnails (Upload)](https://docs.narrative.video/api-reference/narrative/generate-thumbnails.md): Generate product thumbnails from uploaded video file. Returns 3 thumbnails for videos ≤15s, 5 thumbnails for videos >15s.
- [Introduction](https://docs.narrative.video/api-reference/instinct/introduction.md): Instinct API - AI-powered video editing and caption generation
- [Generate Shortform Edit](https://docs.narrative.video/api-reference/instinct/generate-shortform-edit.md): AI-powered video editing with automatic retake and pause removal
- [Introduction](https://docs.narrative.video/api-reference/clipping/introduction.md): AI-powered social media hook generation and video analysis
- [Prepare Video](https://docs.narrative.video/api-reference/clipping/prepare-video.md): Merge multiple episodes into a continuous video with smart transitions
- [Generate Hook](https://docs.narrative.video/api-reference/clipping/generate-hook.md): Create engaging social media hooks with cliffhangers
- [Summarize Video](https://docs.narrative.video/api-reference/clipping/summarize-video.md): Generate AI-powered video summaries
- [Extract Transcript](https://docs.narrative.video/api-reference/clipping/extract-transcript.md): Extract audio-visual transcript with timestamps and speaker diarization
- [Introduction](https://docs.narrative.video/api-reference/sports/introduction.md): Sports video analysis and highlight generation with async task processing
- [Extract Metadata](https://docs.narrative.video/api-reference/sports/extract-metadata.md): Start async task to extract structured metadata from video
- [Get Metadata Task](https://docs.narrative.video/api-reference/sports/get-metadata-task.md): Poll metadata extraction task status and retrieve results
- [Generate Highlights](https://docs.narrative.video/api-reference/sports/generate-highlights.md): Start async task to generate highlight reel from video
- [Get Highlights Task](https://docs.narrative.video/api-reference/sports/get-highlights-task.md): Poll highlight generation task status and retrieve results
- [Introduction](https://docs.narrative.video/api-reference/search/introduction.md): Index and search video clips with natural language
- [Create Index](https://docs.narrative.video/api-reference/search/create-index.md): Create a new search index for video clips
- [Delete Index](https://docs.narrative.video/api-reference/search/delete-index.md): Permanently delete a search index and all its contents
- [Upload to Index](https://docs.narrative.video/api-reference/search/upload-to-index.md): Upload video files to a search index
- [Delete from Index](https://docs.narrative.video/api-reference/search/delete-from-index.md): Remove an item from a search index
- [Search Clips](https://docs.narrative.video/api-reference/search/search-clips.md): Search video clips using natural language queries

## OpenAPI Specs

- [sports-openapi](https://docs.narrative.video/api-reference/sports-openapi.json)
- [clipping-openapi](https://docs.narrative.video/api-reference/clipping-openapi.json)
- [search-openapi](https://docs.narrative.video/api-reference/search-openapi.json)
- [instinct-openapi](https://docs.narrative.video/api-reference/instinct-openapi.json)
- [narrative-openapi](https://docs.narrative.video/api-reference/narrative-openapi.json)
- [openapi](https://docs.narrative.video/api-reference/openapi.json)