---
title: "Summarize a source"
method: POST
path: "/summarize"
---

# Summarize a source

`POST /summarize`

Summarize a video from a URL or file path. All fields from the CLI are supported. The response includes the generated summary in the requested format (markdown, json, or html).

## Request body

- SummarizeRequest
  - `source` string, required — Video URL or file path
  - `type` 'YouTube Video' | 'Video URL' | 'Google Drive Video Link' | 'Dropbox Video Link' | 'Local File' | 'TXT', nullable — Source type
  - `provider` string, nullable — Provider name from config
  - `prompt_type` string, nullable — Summary style
  - `chunk_size` integer, nullable — Characters per chunk
  - `parallel_calls` integer, nullable — Concurrent API requests
  - `max_tokens` integer, nullable — Max output tokens per chunk
  - `language` string, nullable — Caption/transcription language
  - `output_language` string, nullable — Summary output language
  - `force_download` boolean — Skip captions, download audio
  - `transcription` 'Cloud Whisper' | 'Local Whisper', nullable — Cloud Whisper or Local Whisper
  - `whisper_model` 'tiny' | 'base' | 'small' | 'medium' | 'large', nullable — Whisper model size
  - `speed` number, nullable — Playback speed for audio preprocessing or visual-mode video
  - `output_format` 'markdown' | 'json' | 'html', nullable — markdown, json, or html
  - `visual` boolean — Send video directly to vision model
  - `use_proxy` boolean, nullable — Route through Webshare proxy
  - `api_key` string, nullable — Override API key
  - `base_url` string, nullable — Override API base URL
  - `model` string, nullable — Override model name
  - `cobalt_url` string, nullable — Cobalt base URL
  - `verbose` boolean — Verbose progress output

## Response `200`

Successful Response

- SummarizeResponse
  - `success` boolean, required
  - `source` string, required
  - `summary` string, required
  - `format` string, required
  - `model` string, nullable
  - `prompt_type` string, nullable
  - `processing_time_seconds` number, required
  - `error` string, nullable
  - `error_type` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/martinopiaggi/apis/summarize-api.md) · [All operations](https://skmtc.net/martinopiaggi/apis/summarize-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/martinopiaggi/summarize-api/versions/abf737f34b72/schema)