Utilities

POST /v1/video/summarize

Video File Summarizer API

Transcribe an uploaded file with Whisper, then return an AI summary — 1 credit per minute + 1 for the summary.

1 credit/min +1 per request

TL;DR

Transcribe an uploaded file with Whisper, then return an AI summary — 1 credit per minute + 1 for the summary. The Video File Summarizer API (Utilities) is a single authenticated POST request to /v1/video/summarize that responds with clean JSON and costs 1 credit/min +1. Pass cache=true for a free 24h cache hit; default is always fresh. Start with 100 free credits — no credit card.

What is the Video File Summarizer API?

Upload a video or audio file (multipart form field `file`) to transcribe with Whisper and get an AI summary (key points, topics, sentiment) plus the transcript. Billed at 1 credit per minute of audio (rounded up) plus 1 credit for the summary.

What you get

2–3 paragraph AI summary
4–8 bullet key points and detected topics
Overall sentiment and tone
Built on the transcript under the hood

Try it

Fill in the parameters below and copy a ready-to-run request in your language of choice.

Parameters

file*fileVideo or audio file to transcribe and summarize (multipart form upload).

API keyoptionalPaste your key to get a ready-to-run snippet. It stays in your browser.

curl "https://api.captapi.com/v1/video/summarize?file=%40video.mp4" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Edit the parameters and the code updates instantly. Switch languages and hit copy.

Example response

{
  "success": true,
  "data": {
    "summary": "A concise walkthrough of how to extract structured data from social video at scale.",
    "keyPoints": [
      "One key per platform",
      "24h shared cache",
      "No OAuth required"
    ],
    "topics": [
      "APIs",
      "data extraction",
      "automation"
    ],
    "sentiment": "positive"
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Source. Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.

Response structure

A successful call returns success, cached, creditsUsed, and a data object with the following fields:

Summary

summaryAI-generated summary of the video (2–3 paragraphs).
sentimentOverall tone of the content (positive, neutral, negative).

Structured output

keyPointsArray of the most important takeaways.
topicsArray of detected topics and themes.

Parameters

Name	Type	Required	Description
file	file	Yes	Video or audio file to transcribe and summarize (multipart form upload).

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 1 credit/min +1. Pass cache=true for a free 24h cache hit; default is always fresh.

Using an AI agent? This endpoint is the MCP tool video_summarize via @captapi/mcp. Set it up →

How it works

1. Sign up — get 100 free credits, no card required.
2. Create a key from your dashboard.
3. Send one request to /v1/video/summarize and parse the JSON response.

Use cases

Content Triage

Decide what's worth watching without watching it.

Newsletters & Digests

Auto-generate summaries for roundups and emails.

Research

Condense long videos into key points at scale.

SEO

Generate descriptions and meta content from videos.

Social

Draft captions and posts from video content.

Frequently asked questions

What does the Video File Summarizer API do?+

The Video File Summarizer API lets you generate an AI summary with key points and topics from a public Utilities uploaded video or audio file using one POST request to /v1/video/summarize. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Video File Summarizer API cost?+

Billing is 1 credit per minute of audio (rounded up) plus 1 credit for the AI summary. Failed or empty results are never charged.

Do I need a Utilities API key or OAuth?+

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Which AI model powers the summaries?+

Summaries are generated with GPT-4o-mini for a strong balance of quality, speed, and cost, built on top of the transcript.

Is the Video File Summarizer API suitable for production use?+

Yes. It is a stable REST endpoint with predictable JSON and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

More Utilities APIs

Post Analytics API Compare Analytics API Video File Transcript API

Ready to use the Video File Summarizer API?

Get started free