{"openapi":"3.1.0","info":{"title":"Orvento","summary":"YouTube video summaries and transcripts for AI agents","version":"0.1.0","x-guidance":"Turns a YouTube video into text. Pass the video as `url` (YouTube link or 11-character ID).\nGET /v1/summary?url=...&lang=en returns {\"summary\": \"<Markdown>\"}: a TL;DR, 3-6 key points and a timestamped section outline, under 250 words, written in `lang` (en, ru, de, pt-BR, ...).\nGET /v1/transcript?url=... returns JSON with timestamped subtitle segments, the full text and video metadata (title, channel, description, duration, chapters).\nCall summary to learn what a video says; call transcript for exact quotes, timestamps or your own processing. Works for any video with subtitles (author-made or auto-generated); without them you get 404 no_subtitles. Pay per call in USDC via x402 (Circle Gateway); errors are not charged.","contact":{"email":"ediileekaa@gmail.com"}},"servers":[{"url":"https://orvento.link"}],"paths":{"/v1/transcript":{"get":{"summary":"Transcript","description":"Subtitles of a YouTube video as JSON: timestamped segments, full text and video metadata (title, channel, description, chapters). Prefers author-uploaded subtitles (English first), then auto-generated ones in the original language.","operationId":"transcript_v1_transcript_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"YouTube video URL or 11-character video ID","title":"Url"},"description":"YouTube video URL or 11-character video ID"},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Ignore the cached copy and fetch from YouTube again","default":false,"title":"Refresh"},"description":"Ignore the cached copy and fetch from YouTube again"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transcript"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Gateway"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]}}},"/v1/summary":{"get":{"summary":"Summary","description":"Markdown summary of the video: TL;DR, key points and a section-by-section outline.\n\nX-API-Key callers get the Markdown itself (text/markdown); x402 payers get\n{\"summary\": \"<markdown>\"} (application/json). Errors are JSON as elsewhere.","operationId":"summary_v1_summary_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"YouTube video URL or 11-character video ID","title":"Url"},"description":"YouTube video URL or 11-character video ID"},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"Language of the summary, e.g. en, ru, de","default":"en","title":"Lang"},"description":"Language of the summary, e.g. en, ru, de"},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Regenerate the summary instead of returning a cached one","default":false,"title":"Refresh"},"description":"Regenerate the summary instead of returning a cached one"}],"responses":{"200":{"description":"Markdown for X-API-Key callers, JSON {summary} for x402 payers (override with Accept: text/markdown or application/json).","content":{"text/markdown":{"schema":{"type":"string"}},"application/json":{"schema":{"properties":{"summary":{"title":"Summary","type":"string"}},"required":["summary"],"title":"SummaryJson","type":"object"}}}},"400":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Request"},"401":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized"},"402":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Payment Required"},"404":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Not Found"},"502":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad Gateway"},"503":{"content":{"text/markdown":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Service Unavailable"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"Chapter":{"properties":{"start":{"type":"number","title":"Start"},"end":{"type":"number","title":"End"},"title":{"type":"string","title":"Title"}},"type":"object","required":["start","end","title"],"title":"Chapter"},"ErrorBody":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"}},"type":"object","required":["code","message"],"title":"ErrorBody"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"type":"object","required":["error"],"title":"ErrorResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Segment":{"properties":{"start":{"type":"number","title":"Start"},"duration":{"type":"number","title":"Duration"},"text":{"type":"string","title":"Text"}},"type":"object","required":["start","duration","text"],"title":"Segment"},"Transcript":{"properties":{"video":{"$ref":"#/components/schemas/VideoMeta"},"language":{"type":"string","title":"Language"},"kind":{"type":"string","enum":["manual","auto"],"title":"Kind"},"segments":{"items":{"$ref":"#/components/schemas/Segment"},"type":"array","title":"Segments"},"text":{"type":"string","title":"Text"}},"type":"object","required":["video","language","kind","segments","text"],"title":"Transcript"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoMeta":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"},"upload_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Upload Date"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"chapters":{"items":{"$ref":"#/components/schemas/Chapter"},"type":"array","title":"Chapters"}},"type":"object","required":["id","url","title","description","channel","duration","upload_date","language","tags","chapters"],"title":"VideoMeta"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"externalDocs":{"url":"https://orvento.link/"}}