---
title: "Agent Transcript"
method: POST
path: "/v1/transcript"
tags: ["agent"]
---

# Agent Transcript

`POST /v1/transcript`

## 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/transcript`
- Auth: none declared

Return a video's raw transcript inline (the cheaper SKU — no model run).
Pay-per-call via x402. The transcript is fetched once and cached, so repeat
calls for the same video don't re-hit YouTube. Charged only on success.

## Request body

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

## Response `200`

Successful Response

- AgentTranscriptResponse
  - `youtube_video_id` string, required
  - `transcript` string, 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)