{"openapi":"3.1.0","info":{"title":"TubeSubtitles Developer API","version":"1.0.0","description":"Authenticated Edge API for video subtitle extraction (1 credit), causal 6-section AI executive briefings (5 credits idempotent per video+lang), and streaming transcript Q&A (3 credits)."},"servers":[{"url":"https://tubesubtitles.com"}],"security":[{"ApiKeyHeader":[]},{"BearerAuth":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}},"ChatRequest":{"type":"object","required":["videoId","message"],"properties":{"videoId":{"type":"string","description":"11-character YouTube video ID or URL"},"message":{"type":"string","minLength":1,"maxLength":4000},"language":{"type":"string","description":"Optional BCP-47 track language (e.g. en, de)"},"history":{"type":"array","maxItems":20,"items":{"type":"object","required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"]},"content":{"type":"string","minLength":1,"maxLength":4000}}}}}}}},"paths":{"/api/v1/subtitles":{"get":{"summary":"Extract video subtitles (1 credit)","parameters":[{"name":"videoId","in":"query","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","default":"en"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["srt","vtt","json","json3"],"default":"srt"}}],"responses":{"200":{"description":"Formatted SRT, WebVTT, or structured JSON cues"},"400":{"description":"Validation failed"},"401":{"description":"Missing or invalid API key"},"403":{"description":"Revoked key, cross-tenant key, or Pro format required"},"429":{"description":"Burst rate limit or monthly credit quota exceeded"}}}},"/api/v1/summary":{"get":{"summary":"Generate or retrieve 6-section AI Executive Brief (5 credits once per video+lang, 0 on repeat)","parameters":[{"name":"videoId","in":"query","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","default":"en"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["json","md"],"default":"json"}}],"responses":{"200":{"description":"6-section executive summary in JSON or Markdown"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Insufficient monthly credits or burst rate limit"},"503":{"description":"Workers AI inference unavailable in current environment"}}}},"/api/v1/chat":{"post":{"summary":"Stream AI Q&A grounded in video transcript (3 credits)","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Server-Sent Events (text/event-stream) token stream"},"400":{"description":"Invalid JSON body or videoId"},"401":{"description":"Missing or invalid API key"},"429":{"description":"Insufficient monthly credits or burst rate limit"},"503":{"description":"Workers AI inference unavailable in current environment"}}}}}}