Orvento

Agent service · Media

YouTube summaries and transcripts for AI agents

Give your agent a YouTube link and get back a compact summary in any language, or the full timestamped transcript with video metadata. Pay per call in USDC over x402. No signup, no API key.

  • x402
  • Circle Gateway
  • USDC
  • Gasless
  • No charge on failed calls

Endpoints

Two calls, priced per request

MethodEndpointPrice
GET https://orvento.link/v1/summary
A compact Markdown summary written from the video's subtitles, description and chapters: a TL;DR, 3–6 key points and a timestamped section-by-section outline, under 250 words.
  • url — YouTube URL or 11-character video ID (required)
  • lang — summary language: en (default), ru, de, pt-BR, …
  • Returns {"summary": "<markdown>"}
 $0.01
GET https://orvento.link/v1/transcript
The full transcript as JSON: timestamped segments, plain text and video metadata (title, channel, description, duration, tags, chapters). Uses subtitles uploaded by the author when available, English first; otherwise the auto-generated track in the original language.
  • url — YouTube URL or 11-character video ID (required)
 $0.003

How it works

Payment is the authentication

  1. RequestYour agent calls an endpoint. Without payment it gets 402 Payment Required with the price and the accepted networks in the PAYMENT-REQUIRED header.
  2. SignThe agent signs a gasless USDC authorization from its Circle Gateway balance and repeats the request with a PAYMENT-SIGNATURE header.
  3. ReceiveThe service does the work and returns 200 with the result. The receipt comes back in the PAYMENT-RESPONSE header.

Examples

What your agent gets back

Summary · $0.01

GET /v1/summary?url=https://www.youtube.com/watch?v=jNQXAC9IVRw&lang=en

Response: {"summary": "…"}. The field holds this Markdown:

## TL;DR
A 19-second zoo clip in which the uploader stands in front of elephants and says their long trunks are the cool thing about them.

## Key points
- Filmed in front of elephants at a zoo.
- The speaker says the cool thing is their really long trunks.
- He admits there is little more to say.

## Section by section
- 00:00 — Intro: standing in front of the elephants.
- 00:05 — The cool thing: the elephants' long trunks are praised.
- 00:17 — End: a brief closing remark.

Transcript · $0.003

GET /v1/transcript?url=https://www.youtube.com/watch?v=jNQXAC9IVRw 
{
  "video": {
    "id": "jNQXAC9IVRw",
    "title": "Me at the zoo",
    "channel": "jawed",
    "duration": 19.0,
    "upload_date": "2005-04-24",
    "chapters": [
      {"start": 0.0, "end": 5.0, "title": "Intro"},
      {"start": 5.0, "end": 17.0, "title": "The cool thing"},
      {"start": 17.0, "end": 19.0, "title": "End"}
    ],
    …
  },
  "language": "en",
  "kind": "manual",
  "segments": [
    {"start": 1.2, "duration": 2.16,
     "text": "All right, so here we are, in front of the elephants"},
    {"start": 5.318, "duration": 2.656,
     "text": "the cool thing about these guys is that they have really..."},
    …
  ],
  "text": "All right, so here we are, in front of the elephants …"
}

Circle CLI

Call it from the command line

# Check the price and accepted networks (no payment)
circle services inspect "https://orvento.link/v1/summary?url=jNQXAC9IVRw&lang=en"

# Pay and get the result
circle services pay "https://orvento.link/v1/summary?url=jNQXAC9IVRw&lang=en" \
  -X GET --address <your-agent-wallet> --chain <CHAIN>

New to the Circle CLI? Ask your agent to run curl -sL https://agents.circle.com/skills/setup.md and follow the setup instructions. Machine-readable spec: /openapi.json.