---
title: "Agent Summarize"
method: POST
path: "/v1/summarize"
tags: ["agent"]
---

# Agent Summarize

`POST /v1/summarize`

## Request

- Base URL: `https://api.sumvid.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sumvid.app/v1/summarize`
- Auth: none declared

Summarize a YouTube video and return it inline. Pay-per-call via x402
(no account/key). Runs synchronously: transcript fetch (if new) + Claude
Haiku, answered from the shared cache when possible. Payment settles only on
success — a bad URL, missing captions, or model error returns an error and
is never charged.

## Request body

- SummarizeRequest
  - `url` string, required
  - `max_credits` integer
  - `language` string, nullable

## Response `200`

Successful Response

- AgentSummaryResponse
  - `youtube_video_id` string, required
  - `summary` string, required
  - `model` string, required
  - `cached` boolean, required
  - `language_code` string
  - `title` string, nullable
  - `channel` string, nullable
  - `thumbnail_url` string, nullable
  - `duration_seconds` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sumvid/apis/summarize-vid.md) · [All operations](https://skmtc.dev/sumvid/apis/summarize-vid/llms.txt) · [OpenAPI document](https://skmtc.dev/sumvid/apis/summarize-vid/revisions/c03d66e07deb?raw)